MCS entry (SMPPTS)

The MCS entry is a copy of a SYSMOD exactly as it was received from the SMPPTFIN data set. The MCS entry is in the SMPPTS data set, which is used as a warehouse for SYSMODs. When SMP/E receives a SYSMOD, it stores the SYSMOD as a separate member in the SMPPTS. The member name matches the SYSMOD ID, and each member is an MCS entry. SMP/E also creates a SYSMOD entry in the global zone to describe the SYSMOD that was received. Thus, the MCS entry and the global zone SYSMOD entry are closely related.

When SMP/E accepts or applies SYSMODs, it gets them from the MCS entries in the SMPPTS. An MCS entry is generally kept in the SMPPTS until the associated SYSMOD is accepted; then the entry is deleted.

You may want SMP/E to save the MCS entries after ACCEPT processing, for example, if you plan to do a system generation. To do this, specify NOPURGE in the OPTIONS entry that is in effect during ACCEPT processing.
Likewise, you may want to save the MCS entries after RESTORE processing. To do this, specify NOREJECT in the OPTIONS entry that is in effect during RESTORE processing.

Subentries

The MCS entry contains no SMP/E data and appears to the system as a member of a normal partitioned data set.

LIST Examples

To list all the MCS entries in the SMPPTS, you can use the following commands:

SET      BDY(GLOBAL)        /* Set to global.           */.
LIST     MCS                /* List all MCS entries.    */.

To list specific MCS entries, you can use these commands:

SET      BDY(GLOBAL)        /* Set to global.           */.
LIST     MCS(UZ12345,       /* List only these two      */
             UZ12346)       /* entries.                 */.

The format of the LIST output for each MCS entry is the same for both of these commands. The only difference is the number of MCS entries listed.

Figure 1 is an example of LIST output for MCS entries.

Figure 1. MCS entry: sample LIST output

PAGE nnnn  - NOW SET TO zzzzzz ZONE nnnnnnn  DATE mm/dd/yy TIME hh:mm:ss SMP/E 36.nn SMPLIST OUTPUT

SMPPTS        MCS ENTRIES


  NAME

UZ12345   MCS             = ++PTF(UZ12345).
                            ++VER(Z038) FMID(JXY1102).
                            ++MOD(XYMOD01) DISTLIB(AOS12).

UZ12346   MCS             = ++PTF(UZ12346).
                            ++VER(Z038) FMID(FXY1102).
                            ++JCLIN.
                            //JOB      JOB 'accounting info',MSGLEVEL=(1,1)
                            //STEP1    EXEC PGM=IEBCOPY
                            //MACLIB   DD DSN=SYS1.MACLIB,DISP=SHR
                            //AMACLIB  DD DSN=SYS1.AMACLIB,DISP=SHR
                            //SYSIN    DD *
                             COPY INDD=AMACLIB,OUTDD=MACLIB
                            /*
                            ++MAC(MAC01) DISTLIB(AMACLIB).

As the example for UZ12346 shows, SMP/E includes inline JCLIN when listing the MCS entries.

You can use various SYSMOD-related LIST operands to limit which MCS entries are listed. For more information, see SYSMOD entry (distribution and target zone) and SYSMOD entry (global zone).

In addition to the LIST command, you can use standard system utility programs (such as IEBGENER, IEBPTPCH, IEHLIST, and so on) or products such as ISPF to display these entries or information about the data set.

UCLIN Examples

You cannot use UCLIN to add, update, or delete MCS entries. However, you can use the REJECT command to delete MCS entries. For more information about the REJECT command, see SMP/E for z/OS Commands.

Do not use system utility programs to update MCS entries. The global zone SYSMOD entry is coordinated with the MCS entry. Any changes to the MCS entry made outside of SMP/E may get these entries out of synchronization and can result in unpredictable results when the associated SYSMOD is processed.