Syntax for Assembler Macros › #UTABGEN › #UTABGEN Usage

#UTABGEN 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 #UTABGEN macro, you can assign an OCF/BCF activity number to one or more Utility commands.

• You can associate a specific OCF/BCF activity number (0 through 255) with a utility command.
• You can associate a security label (A through Z) with a utility command.

An activity number of zero turns off security for that security-label or command-code. Coding zero is a useful way to turn off security, without deleting the command-code from the #UTABGEN source definition.

Only commands that are being secured need to be coded. If omitted, they default to an activity code of zero.

Security labels must be defined before they can be assigned to command codes.

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

Generating the #UTABGEN Macro

The source file that specifies the #UTABGEN macro can only contain one macro. Once assembled, the resulting object must be link edited as the stand-alone module IDMSUTAB.

Example 1:

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

         #UTABGEN (A,3,B,10),                                          X
               (OCF,FORMAT,A,LOCK,A,UNLOCK,A),                         X
               (BCF,ARCHIVEJOURNAL,B,ARCHIVELOG,B),                    X
               (FIXPAGE,50)
          END

This example shows an activity code of 3 being assigned to security-label A and activity code 10 being assigned to security-level B.

OCF indicates the commands that follow (within the parentheses) will be assigned activity codes only when running in the online command facility OCF or as part of the batch command facility IDMSBCF running in central mode. Commands FORMAT, LOCK and UNLOCK are associated with security-label A. Since security-label A is currently assigned to the OCF/BCF activity code 3, the Format, Lock, and Unlock commands are assigned activity code 3.

BCF indicates that the commands within that group will only be secured when running as part of the batch command facility IDMSBCF running in local mode only. In this example, the Archive Journal and Archive Log commands will be assigned to the activity code 10, via the security-label B.

FIXPAGE is not qualified so the activity code 50 will be assigned to the Fix Page utility in both OCF and BCF.

Example 2:

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

         #UTABGEN (FORMAT,14,FIXPAGE,14)
          END

In this example, the activity number of 14 is assigned the utility command codes FORMAT and FIXPAGE. Because the codes are not identified as being either OCF or BCF, the commands associated with these codes will be secured in both online and batch, and both will use the same activity number.