The Create Page Segment (CRTPAGSEG) command creates a page segment space object by copying a user-supplied database file to an internal space object. The user must load the page segment resource into the database from a remote system (such as a System/370) or from an external medium (such as a tape) and must put the resource in the SAA format that can be processed by the operating system.

Parameters

Keyword	Description	Choices	Notes
PAGSEG	Page segment	Qualified object name	Required, Positional 1
	Qualifier 1: Page segment	Name
	Qualifier 2: Library	Name, *CURLIB
FILE	File	Qualified object name	Required, Positional 2
	Qualifier 1: File	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB
MBR	Member	Name, *PAGSEG	Optional, Positional 3
TEXT	Text 'description'	Character value, *MBRTXT, *BLANK	Optional
REPLACE	Replace page segment	*YES, *NO	Optional
AUT	Authority	Name, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE	Optional

Top

Page segment (PAGSEG)

Specifies the page segment being created.

This is a required parameter.

Qualifier 1: Page segment

name

Specify the name of the page segment.

Qualifier 2: Library

*CURLIB

The current library is used to locate the page segment. If no library is specified as the current library for the job, QGPL is used.

name

Specify the library name used to locate the page segment.

Source file (FILE)

Specifies the file containing the page segment records sent to this system.

This is a required parameter.

Qualifier 1: File

name

Specify the name of the file to be used.

Qualifier 2: Library

*LIBL

All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

The current library for the job is used to locate the file. If no library is specified as the current library for the job, QGPL is used.

name

Specify the library where the file is located.

Source file member (MBR)

Specifies the file member containing the page segments records.

*PAGSEG

The name of the file member is specified in the Page segment (PAGSEG) parameter.

name

Specify the name of the member in the file specified by the Source file (FILE) parameter.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*MBRTXT

The text is taken from the file member being used to create the page segment. You can add or change text for a database source member by using the Source Entry Utility (STRSEU) command, or by using either the Add Physical File Member (ADDPFM) command or the Change Physical File Member (CHGPFM) command. If the file is an inline file or a device file, the text is blank.

*BLANK

No text is specified.

character-value

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

Replace page segment (REPLACE)

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

*YES

The existing page segment is replaced.

*NO

If a page segment with same name exists on the system, the create operation fails. The existing page segment is not replaced.

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.

*LIBCRTAUT

The system determines the authority for the object by using the value specified on the Create authority (CRTAUT) parameter on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified on the Create authority (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 (*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.

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

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

*EXCLUDE

The user cannot access the object.

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.

Examples

CRTPAGSEG   PAGSEG(MYLIB/PAGSEG1)  FILE(*LIBL/PAGSGMTS)
            MBR(*PAGSEG)
            AUT(*ALL)  TEXT('canned paragraph 1')

This command creates the page segment PAGSEG1 in MYLIB and uses the PAGSGMTS member, PAGSEG1 as input to the command. Specifying *ALL for the AUT parameter allows any user to perform most object-oriented commands against it. The text contains the description of the object.

Error messages

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

CPF9809

Library &1 cannot be accessed.

CPF9810

Library &1 not found.

CPF9812

File &1 in library &2 not found.

CPF9822

Not authorized to file &1 in library &2.

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.