SE.3 SETUP - Preamble

Use the PREAMBLE function for setting up common commands used in every action or query. The PREAMBLE provides a simple way to customize the product. You can add an INCLUDE command in the preamble to add a user or installation-defined member to every run.

You specify the preamble commands from the Setup - Preamble panel shown in Figure 1. To use the preamble commands each time a query is run, select the Execute preamble commands before every query option.

Use this option for including the Commands entered on the Preamble panel in every call to the program. You can temporarily disable the Preamble function by removing the selection (/) from the Execute preamble commands before every query on the panel. If no commands have been specified, this field is not selected.

Figure 1. Setup - Preamble

 Menu   Options   Info   Commands                                 
-------------------------------------------------------------------------------
                        zSecure Suite  - Setup - Preamble
Command ===> _________________________________________________________________
 
_  Execute preamble commands before every query
 
Enter CARLa commands below (no conversion to UPPER case):
>
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________
> ________________________________________________________________________

Every report uses the statements on the preamble panel. These statement can be defined using the individual PREAMBLE function or as a system default using the Setup Default function available on the Setup menu.

The preamble statement can, for example, be used to create an override of existing fields that are used in the standard queries. If you want to suppress a user or group ID when displaying an access list for all DATASET or general resource profiles, you can use the following PREAMBLE statement:

   DEFINE ACL SUBSELECT,
          ACL(ID<>(IBMUSER,SYSAUDIT) OR ACCESS<>ALTER)

This statement redefines the ACL output variable to exclude all access list entries with an access level of ALTER for the IDs IBMUSER or SYSAUDIT. Access list entries for other IDs or other access levels are shown. This modified ACL output variable is used in all displays where the variable is not redefined again. For more information, see the information about the DEFINE command in zSecure CARLa Command Language.

An other example of using the preamble function is to specify the serialization option for the zSecure data sets used in the reports. You can use a statement similar to the following one:

OPTION SERIALIZATION(ENQ(CKRDSN),WAIT,MAXWAIT(2))

If the data sets that your report needs are not immediately available, wait for a maximum of two minutes. When the data sets become available earlier, the report is generated. During the waiting period, you can use the attention key to interrupt waiting and stop the program. You can try the report at a later time when the data sets are available.