COZTOOLS-Create SAVxxx List (CRTSAVL)

The COZTOOLS-Create SAVxxx List (CRTSAVL) command Creates a list of library and/or Object names that may be omitted from a subsequent SAVLIB or SAVOBJ command. It creates a user space that may be specified on the CMDUSRSPC parameter of the SAVxxx commands. Then the LIB(*USRSPC) or OBJ(*USRSPC) or OMITLIB(*USRSPC) or OMITOBJ(*USRSPC) parmaters may be specified. on the SAVxxx command to indicate which objects are included or omitted from the save. The SAVL name is specified on the CMDUSRSPC parameter of the SAVLIB and SAVOBJ commands. CRTSAVL creates the user space if it doesn't exist. It is a future objective to provide a way to alter the save list. Today it is recommended that the CRTSAVL be stored in a user-written CL program so that the list may be modified and rerun without needing to remember what libraries or objects had been previously specified.

Restrictions:

You must have *SAVRST authority to run any SAVLIB or SAVOBJ command.

Parameters

Keyword	Description	Choices	Notes
SAVL	Save List name	Qualified object name	Optional, Positional 1
	Qualifier 1: Save List name	Name, MYSAVLIST
	Qualifier 2: Library	Name, CURLIB, LIBL
OMITLIB	Omit Library name(s)	Values (up to 300 repetitions): Generic name, name, *NONE	Optional, Positional 2
OMITOBJ	Omit Object name(s)	Single values: NONE Other values (up to 300 repetitions): Element list*	Optional, Positional 3
	Element 1: Object	Qualified object name
	Qualifier 1: Object	Generic name, name, *ALL
	Qualifier 2: Library	Name, *ALL
	Element 2: Object type	Character value, *ALL
LIB	Include Lib names(s)	Values (up to 300 repetitions): Generic name, name, *NONE	Optional, Positional 4
OBJ	Include Object name(s)	Single values: NONE Other values (up to 300 repetitions): Element list*	Optional, Positional 5
	Element 1: Object	Generic name, name
	Element 2: Object type	Character value, *ALL

Top

Save List name (SAVL) Parameter

Specifies name of the Save List (a *USRSPC) that will contain the list of included and omitted object and library names. If the user space does not exist, it is created.

Qualifier 1: SAVL Name

MYSAVLIST: The default name is MYSAVLIST ("My SAV List"), but can be changed to anything you want using the IBM-supplied CHGCMDDFT command.
name: Specify the name of the save list where the list of objects and librarys is stored.

Qualifier 2: Library

*CURLIB: The SAV List user space is created in the current library.
*LIBL: The user space is created in the current library unless it already exists. If *LIBL is specified and the SAVL user space already exists, then that save list is used.
name: Specify the name of library where the SAVL is located;

Omit Library name(s) (OMITLIB)

Specifies the list of library names, generic* or full name that are added to the omit list.

You can specify 300 values for this parameter.

*NONE: No libraries are omitted from the SAVxxx operation.
generic-name*: Specify the library name as a generic name XXXX* or a full name XXXXYYYY.

Omit Object name(s) (OMITOBJ)

Specifies a list of objects to be added to the SAV/RST omit list. This is a 3-part parameter. The object, library and object type are specified as OMITOBJ( (lib1/obj1 *TYPE1) (lib2/obj2 *TYPE2)...)

Single values

*NONE: No objects are added to the omit list.

Other values (up to 300 repetitions)

Element 1: Object

Qualifier 1: Object

*ALL: All objects in the specified library of the specified type are omitted.
generic-name: Specify the object name, generic, full or *ALL that is added to the omit list.
name: Specify the name of <...>

Qualifier 2: Library

*ALL: <...>
name: Specify the name of <...>

Element 2: Object type

*ALL: <...>
character-value: Specify the <...>

Include Library Name(s) (LIB)

Specifies the list of library names, generic* or full name that are added to the Save List. These libraries are included when doing a SAVLIB or SAVOBJ command and specying LIB(*USRSPC) or OBJ(*USRSPC) on those commands in addition to the CMDUSRSPC parameter.

You can specify 300 values for this parameter.

*NONE: No libraries are added to the SAVE LIST. The LIB parameter of the SAVLIB and SAVOBJ commands should specify the library names to be included in the save operation.
generic-name*: Specify the library name as a generic name XXXX* or a full name XXXXYYYY.

Include Object name(s) (OBJ)

Specifies a list of objects to be added to the SAVE LIST. These objects are included in the save operation when OBJ(*USRSPC) is specified on a SAVOBJ command that include the CMDUSRSPC parameter. This is a 2-part parameter. The object and object type are specified as OBJ( (obj1 *TYPE1) (obj2 *TYPE2)...)

Single values

*NONE: No objects are added to the SAVE LIST.

Other values (up to 300 repetitions)

Element 1: Object

Qualifier 1: Object

*ALL: If *ALL is specified for the Object name, then all objects in the specified library of the type specified are included in the save operation.
generic-name: Specify the object name, generic, full or *ALL that is added to the SAVE LIST.
name: Specify the name of object that is added to the SAVE List.

Qualifier 2: Library

*ALL: Specifying a library name of *ALL indicates that the object name
name: Specify the name of <...>

Element 2: Object type

*ALL: <...>
character-value: Specify the <...>