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