CRTPAGDFN (Create Page Definition)

CRTPAGDFN Command syntax diagram

 

Purpose

The Create Page Definition (CRTPAGDFN) command creates a page definition by copying a user-supplied iSeries 400 database file to an internal space object. The user must load the source data into the database from a remote system (such as a System/370 system) or external medium (usually tape), and put it in the SAA format that can be processed by the OS/400 system.

Restriction: If networking spooled files to a System/370 system, the first two characters of the page definition name must be 'P1'.

 

Required Parameters

PAGDFN

Specifies the qualified name of the page definition to be created.

The name of the page definition can be qualified by one of the following library values:

*CURLIB: The page definition is created in the current library for the job. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library where the page definition is created.

page-definition-name: Specify the up to 8 characters for the name of the page definition.

FILE

Specifies the qualified name of the database file that contains the page definition records sent to this system.

The name of the database file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

file-name: Specify the name of the database file.

 

Optional Parameters

MBR

Specifies the name of the database file member containing the page definition records.

*PAGDFN: The name specified on the PAGDFN parameter of this command is used.

data-file-member-name: Specify the name of the database file member.

REPLACE

Specifies whether an existing page definition with the same name as the one being created is replaced.

*YES: The page definition is replaced.

*NO: No replacement occurs.

AUT

Specifies the authority given to users who do not have specific authority to the object, who are not on the authorization list, and whose user groups have no specific authority to the object.

*LIBCRTAUT: The system determines the authority for the object by using the value specified on the CRTAUT parameter on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified on the CRTAUT parameter is changed, the new value will not affect any existing objects.

*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.

*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 page definition.

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

*EXCLUDE: The user cannot access the page definition.

authorization-list-name: Specify the name of an authorization list. Users included on the authorization list are granted authority to the object as specified by the list. The authorization list must exist when the object is created.

TEXT

Specifies the text that briefly describes the page description. More information on this parameter is in Commonly used parameters.

*MBRTXT: The text is taken from the database file member used to create the page definition.

*BLANK: No text is specified.

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

Example for CRTPAGDFN

CRTPAGDFN   PAGDFN(*CURLIB/P1DFLT)  FILE(*CURLIB/PAGDFNS)
  MBR(*PAGDFN)  AUT(*EXCLUDE)
  TEXT('Default page definition')

This command creates page definition P1DFLT in the current library or in library QGPL if there is no current library. Input is taken from source file PAGDFNS with member P1DFLT in the current library. Specifying *EXCLUDE for authority restricts use of the object to the owner. The text describes the page definition.

Error messages for CRTPAGDFN

*ESCAPE Messages

CPF2283

Authorization list &1 does not exist.

CPF8056

File &1 in &2 not a physical file.

CPF88C1

Printer resource type &1 &2 was not created in library &3.

CPF9822

Not authorized to file &1 in library &2.

CPF9809

Library &1 cannot be accessed.

CPF9810

Library &1 not found.

CPF9812

File &1 in library &2 not found.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.

CPF9847

Error occurred while closing file &1 in library &2.

CPF9870

Object &2 type *&5 already exists in library &3.