CRTFLR (Create Folder)

CRTFLR Command syntax diagram

 

Purpose

The Create Folder (CRTFLR) command creates folders. Folders are used to organize documents and other folders.

Restriction: If the folder is being created and put into an existing folder, *CHANGE authority for the existing folder is required.

 

Required Parameters

FLR
Specifies the name (ranging from 1 to 12 characters, including an optional extension) of the folder being created. If no extension is included, a folder name can have up to 8 characters. If an extension is included, the extension must start with a period and can have 1, 2, or 3 additional characters. An extension in the folder name allows the user to identify the folder by using specific information that can help the user do a selective listing of folders on the system.

The following characters are not allowed in folder names: /, *, and ?.

 

Optional Parameters

INFLR
Specifies the folder that contains the folder being created.

*NONE: The folder is not created into another folder. This folder is considered a first-level folder.

folder-name: Specify the name (ranging from 1 through 63 characters) of the folder in which the newly created folder is contained.

Note: Because folders can reside within other folders, and because any given folder name is unique only within its containing folder, it may be necessary to link several folder names together to identify a folder. This is commonly called the path to an object within a folder. When more than one folder name is used to indicate the path to a folder:

  • Each folder name is separated by a forward slash (/); backward slashes are not allowed.

  • The complete folder name cannot exceed 63 characters in length.

The syntax of a folder name using multiple names is as follows: 

folder-1.ext/folder-2.ext/folder-3.ext

The first folder name (folder-1) is known as a first-level folder because it contains the other folders that follow. The second folder name is the second-level folder, and so on. 

Examples of valid folder paths:
 
  FOLDER1       (one folder without
                 an extension)
  F1.EXT/F2.EXT (a folder within a folder)
 
Examples of invalid folder paths:
 
  F1///F2            ('null' folders
                      not allowed)
  /F1/F2             (leading slash
                      not allowed)
  F1/NAMETOOBIG/F3   (invalid folder
                      name in path)

AUT
Specifies the authority given to users who do not have specific authority to the folder, who are not on an authorization list, and whose user group has no specific authority to the folder. More information on this parameter is in Commonly used parameters.

*INFLR: The created folder is given the same authority as the folder in which it is included. If INFLR(*NONE) is specified, the authority is *EXCLUDE.

*EXCLUDE: The user cannot access the folder.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the folder.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*USE: The user can perform basic operations on the folder, such as running a program or reading a file. The user cannot change the folder. *USE authority provides object operational authority, read authority, and execute authority.

authorization-list-name: Specify the name of the authorization list. The public authority is set to *AUTL, and the authorization list is attached to the created folder.

ASP
Specifies the ID of the auxiliary storage pool (ASP) in which to create the folder. This parameter can be specified only when INFLR(*NONE) is specified (when you are creating a first level folder).

*INFLR: The folder is created in the ASP of its parent folder. When INFLR(*NONE) is specified, this is the system ASP.

ASP-ID: Specify the identifier (ID) of the ASP in which to create the folder. Valid values are the numbers 1 through 16, which must designate an ASP that is configured on the system. For information on configuring an ASP, see the Backup and recovery topic in the Information Center.

TEXT
Specifies the text that briefly describes the folder object. More information on this parameter is in Commonly used parameters.

*FLR: The text is the same as the folder name specified in the FLR parameter.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

CMDCHRID
Specifies the character identifier (graphic character set and code page) for data being specified as parameter values on this command. This character identifier (CHRID) is related to the display device used to specify the command. More information about CHRID processing is in the Application Display Programming

book.

*SYSVAL: The system determines the graphic character set and code page values for the command parameters from the QCHRID system values.

*DEVD: The system determines the graphic character set and code page values for the command parameter from the display device description where the command is entered. This option is valid only when specified from an interactive job. If this value is specified in an interactive CL program or a batch job, an error message is sent.

Element 1: Character Set

graphic-character-set: Specify the graphic character set of the value supplied in the TEXT parameter. Valid values range from 1 through 999.

Element 2: Code Page

code-page: Specify the code page value used to create the command parameters. Valid values range from 1 through 999.

Examples for CRTFLR

Example 1 

CRTFLR   FLR(QTR1)  INFLR('PAYROLL/1987')
  AUT(*CHANGE)  TEXT('first quarter payroll')

This command creates the folder QTR1 in folder PAYROLL/1987. The public is granted *CHANGE authority to the folder, which allows adding a document to the folder, changing the folder description, or showing the contents of the folder. Folder 1987 is in the PAYROLL folder, which is a first-level folder.

Example 2 

CRTFLR   FLR(MANFCTNG)  INFLR(*NONE)
  ASP(2) AUT(*USE)  TEXT('Manufacturing')

This command creates the folder MANFCTNG as a first level folder in the ASP 2, which has been properly configured on the system. The public is granted *USE authority to the folder, which allows you to show the description or the contents of the folder.

Error messages for CRTFLR

*ESCAPE Messages

CPF8A18
Folder &1 not created.