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


Build and Promote User Exit output data sets

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

If you specify a Build Notify or Promote Verify, Promote Copy, or Promote Purge user exit routine, SCLM generates a sequential data set containing a record for each member changed or verified by build or promote. This data set is not generated for the Build Initial or Promote Initial user exits. Verified members are those eligible for promotion during the promote verification phase. Changed members for build are those members produced due to translator calls. Changed members for promote are those members copied or purged. SCLM puts new data in the data set for the invocation of each exit. User exit routines can use the output data set when called, but the data set is rewritten for later exits and is deleted when the SCLM processor ends.

The data definition names (ddnames) for build and promote exit output data sets are BLDEXIT and PROMEXIT respectively. The attributes of the output data sets are the same for all the exit routines:

RECFM
FB
BLOCK SIZE
3200
LRECL
160

The format of the data set is the same for every exit. The data set contains three 8-character fields and one 16-character status field. A blank separates all fields. The following list defines the fields generated for every build and promote exit routine:

Table 1. User Exit Output Data Set Format
Field Description
GROUP Specifies the 8-character name of the group beginning in column 1.
TYPE Specifies the 8-character name of the type beginning in column 10.
MEMBER Specifies the 8-character name of the member beginning in column 19.
STATUS Specifies the status beginning in column 28.
BUILT/DELETED
Indicates if the member was built or if it was an obsolete output that was deleted. This field is written by BLDNTF.
PROMOTABLE/NOT PROMOTABLE
Indicates if the member is eligible for promotion. This field is written by PRMVFY.
COPY SUCCESSFUL/COPY FAILED/COPY NOT ATTEMPTED
Indicates if the member was copied. This field is written by PRMCOPY. COPY NOT ATTEMPTED can be issued when a promote to a non-key group is performed of a NOT PROMOTABLE member.
PURGE SUCCESSFUL/PURGE FAILED
Indicates if the member was purged. This field is written by PRMPURGE.
The following example shows build user exit output:
  USER1   TYPE1   MEMBER1  BUILT
  USER1   TYPE    MEM1     BUILT
  USER1   TYPE2   MEMBER5  BUILT

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014