Syntax for Assembler Macros › #CTABGEN › #CTABGEN Usage

#CTABGEN Usage

Coding Considerations

All lines except the first one must start in column 16.

All lines except the last one must have a non-blank character in column 72.

General

When you use the #CTABGEN macro, you can assign a DCMT activity number to a DCMT command or to a group of commands:

• You can associate a specific DCMT activity number (1 through 256) with the DCMT command.
• You can associate a site-defined security label (A through Z) with the DCMT command.

  Use of security labels makes it easier to maintain security definitions when several commands and/or command groups are assigned the same DCMT activity number. You define a security label in the #CTABGEN macro itself. You need only change the security label definition in the #CTABGEN macro to modify the security for all associated DCMT commands.

Defining Labels

You make security label assignments in a parenthesized list. Use a comma to separate specifications and parenthesized lists. For example:

----+----1----+----2----+----3----+----4----+----5----+----6----+----7--

         #CTABGEN (A,3,B,10),                                          X
               (N001,A,N002,B,N003,6)

You must define all security labels before beginning the list of DCMT security assignments.

Specifying Command Groups and Command Codes

If a 4-character command code is given for a group of commands and a 7-character command code is given for a particular command within that group, then the DCMT activity number for the particular command overrides the security for the group.

No Effect of LOGIN on Response Messages

Response messages issued for DCMT commands are not affected by the LOGIN specification. Response messages are written to the system log if LOG is given as a destination in the message definition.

z/VSE Sites

At z/VSE sites, the LOGIN parameter, if coded, must be coded following all other #CTABGEN parameters.

Generating the #CTABGEN Macro

The source file that contains the #CTABGEN macro can contain only one macro. The resulting object must be link edited as a stand-alone module IDMSCTAB.

To assemble and link edit the #CTABGEN macro, use the JCL or commands appropriate for your operating system.

Note: For more information, see Appendix A: Security Macro JCL.

Example 1

Assign DCMT activity number 3 to DCMT SHUTDOWN (code N001) and ABORT (code N002) by means of security label A:

----+----1----+----2----+----3----+----4----+----5----+----6----+----7--

         #CTABGEN (A,3),                                               X
               (N001,A,N002,A)

Example 2

Assign different discrete security to several DCMT commands:

----+----1----+----2----+----3----+----4----+----5----+----6----+----7--

         #CTABGEN (A,3,B,10),                                          X
               (N001,A,N002,A,N033,A),                                 X
               (N011,B,N025,B),                                        X
               (N025007,50)

This #CTABGEN macro associates three different DCMT activity numbers (3, 10, and 50) with DCMT commands:

• Number 3 is assigned indirectly, by means of security label A, to the following:
  • SHUTDOWN (N001)
  • ABORT (N002)
  • VARY MEMORY (N033)
• Number 10 is assigned indirectly, by means of security label B, to the following:
  • VARY DATABASE PROGRAM (N011)
  • VARY PROGRAM (N025)
• Number 50 is assigned directly to one DCMT command: DCMT VARY PROGRAM STORAGE PROTECT ON (N025007). To use this DCMT command, a user would require DCMT activity number 50. To use any other DCMT VARY PROGRAM command, the user would require DCMT activity number 10.