z/OS ISPF Software Configuration and Library Manager Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


NOPROM—Change Promote Processing

z/OS ISPF Software Configuration and Library Manager Guide and Reference
SC19-3625-00

The NOPROM service modifies the accounting status of a member's accounting record to change the processing of a member when it is copied to the next level during promotion.

For more information on this option, see Leaving a Member Behind on Promotion.

Command invocation format

The Format of the FLMCMD NOPROM service is:
Read syntax diagramSkip visual syntax diagram
>>-FLMCMD--NOPROM,--project,--prj_def,--group,--type,----------->

>--member,--accesskey,--+-REBUILD---+--,--dd_msgs--------------><
                        +-REMOVE----+               
                        '-NOREBUILD-'               

Call invocation format

The Format of the FLMLNK NOPROM service is:
Read syntax diagramSkip visual syntax diagram
>>-lastrc--:=--FLMLNK('NOPROM',--sclm_id,--group,--type,-------->

>--member,--access_key,--+-REBUILD---+--,--msg_line);----------><
                         +-REMOVE----+                  
                         '-NOREBUILD-'                  

Parameters

project
The project name. The maximum parameter length is 8 characters.
prj_def
The project definition name. It defaults to the project name. The maximum parameter length is 8 characters.
sclm_id
An SCLM ID associated with a given project and project definition. The INIT service generates the SCLM ID. The maximum parameter length is 8 characters.
group
The group at which the member accounting status is to be changed. The maximum parameter length is 8 characters.
type
The type of member whose accounting status is to be changed. The maximum parameter length is 8 characters.
member
Specifies the member whose accounting status is to be changed.
access_key
The access key that is assigned to the member. If the member is locked and the access key is not provided, then the accounting record cannot be updated. The maximum parameter length is 16 characters.
NOREBUILD
By specifying this option, SCLM updates the accounting record to specify an accounting status of NOPROM-N. After building the appropriate member, SCLM while promoting copies the build maps containing the non-promoted member but the member itself is left behind.

If the build map references the member not being promoted, this option causes the build map to be copied during the promote, regardless of the FLMLRBLD macro.

REBUILD
By specifying this option, SCLM updates the accounting record to specify an accounting status of NOPROM-R. After building the appropriate member, SCLM while promoting does not copy the build maps containing the non-promoted member or the member itself. Once the copy phase of the promote is complete, the build function is invoked at the level being promoted into. Because the build maps are missing for members that reference the member not being promoted, those members, and any dependent members, are rebuilt.

This option allows you to rebuild at the next level using the editable member found at that level or above it in the hierarchy.

REMOVE
By specifying this option, SCLM updates the accounting record to specify an accounting status of EDITABLE. SCLM performs a normal promote of the member.
dd_msgs
The ddname indicating the destination of the messages generated by the NOPROM service. If you specify a blank ddname, SCLM routes the NOPROM messages to the default output device, such as your terminal. Otherwise, before you call the NOPROM service, you must allocate the ddname. Use the following attributes: RECFM=F, LRECL=80, BLKSIZE=80. The maximum parameter length is 8 characters. This parameter is used for FLMCMD only.
msg_line
Services that only write one message have a msg_line parameter. Define a program variable that is 80 characters to hold the contents of this message line. This parameter only applies to services called through the FLMLNK interface.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014