Create Folder (CRTFLR)

The Create Folder (CRTFLR) command allows you to create a folder. Folders are used to organize documents and other folders.

Restrictions:

If a folder is created into an existing folder, change (*CHANGE) authority to the existing folder is required.

Parameters

Keyword	Description	Choices	Notes
FLR	Folder	Character value	Required, Positional 1
INFLR	In folder	Character value, *NONE	Optional, Positional 2
TEXT	Text 'description'	Character value, *FLR	Optional
AUT	Authority	Name, INFLR, EXCLUDE, ALL, CHANGE, *USE	Optional
ASP	Auxiliary storage pool ID	1-32, *INFLR	Optional
CMDCHRID	Command character identifier	Single values: SYSVAL, DEVD Other values: Element list	Optional
	Element 1: Graphic character set	Integer
	Element 2: Code page	Integer

Top

Folder (FLR)

Specifies the name of the folder being created.

This is a required parameter.

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

In folder (INFLR)

Specifies the name of the folder that contains the folder being created.

*NONE

The folder is not created within another folder; it is considered a first-level folder.

name

Specify the name of the folder (ranging from 1 through 63 characters) that contains the newly created folder.

Because folders may reside within other folders, and because any given folder name is only unique within its containing folder, you may be required to link several folder names together to identify a folder. This is commonly called the path to an object within a folder. The folder path is:

One or more folder names. If more than one folder name, each is separated by a forward slash (/). An example of two folder names is FOLDERA/FOLDERB.
Not to exceed 63 characters in total length.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*INFLR: If the folder is a first-level folder, the authority is *EXCLUDE. If the folder is not a first-level folder, the authority is copied from the folder specified on the In folder (INFLR) parameter.

*EXCLUDE: The user cannot access the object.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) 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 object.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*USE: The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

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.

Auxiliary storage pool ID (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.
1-32: Specify the identifier (ID) of the ASP in which to create the folder. The value must designate an ASP that is configured on the system. For information on configuring an ASP, see the Backup and Recovery book, SC41-5304.

Command character identifier (CMDCHRID)

Specifies the character identifier (graphic character set and code page) for the data being entered as command parameter values (applies to Text 'description' (TEXT) parameter). The character identifier is related to the display device that was used to enter the command.

Single values

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

*DEVD: The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.

Element 1: Graphic character set

1-32767: Specify the graphic character set to use.

Element 2: Code page

1-32767: Specify the code page to use.

Examples

Example 1: Create a Folder in Another Folder

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: Create a Folder in an ASP

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

This command creates the folder MANFCTNG as a first level folder in user auxiliary storage pool (ASP) 2, which has been previously 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.