ACSTRACE keyword - syncsort_allocation_control_center - Latest

Syncsort™ Storage Management Sms/Debug User Guide
Product type
Software
Portfolio
Integrate
Product family
Syncsort™ software
Product
Syncsort™ Storage Management > Syncsort™ Allocation Control Center
Version
Latest
ft:locale
en-US
Product name
Syncsort Storage Management
ft:title
Syncsort™ Storage Management Sms/Debug User Guide
Copyright
1991
First publish date
2025
ft:lastEdition
2025-12-05
ft:lastPublication
2025-12-05T10:27:31.692000

To perform an ACS logic trace using an alternate set of ACS routines, the ACSTRACE= keyword parameter must be specified in the JCL or on the TSO allocate statement. If a VSAM allocation is to be traced, the ACSTRACE= keyword must be present on the //SMSDEBUG DD DUMMY statement in the JCL. The ACSTRACE= keyword may also be specified instead of the SMSDEBUG= keyword when tracing the active ACS routines. The SMSDEBUG= keyword should not be used when tracing an alternate set of ACS routines.

The ACSTRACE= keyword may specify up to three parameters in the following format:

ACSTRACE=(YES | NO, BEFORE | AFTER | BOTH, SCDS | SCDSBOTH | SCDSONLY)

The parameters are as follows:

  1. Position 1: Indicates whether or not ACS routine logic tracing is to be performed.
  2. Position 2: Indicates whether the contents of the ACS read-only and read-write variables are to be displayed in addition to the ACS routine logic.
  3. Position 3: (Optional) Used to perform alternate ACS routine tracing.

First positional parameter

The first parameter (YES or NO) indicates whether or not ACS routine logic tracing is to be performed.

Tip: Normally, it should be specified as YES.

Second positional parameter

The second parameter (BEFORE / AFTER / BOTH) indicates whether the contents of the ACS read-only and read-write variables are to be displayed in addition to the ACS routine logic.

  • BEFORE: The ACS read-only variables are displayed upon entry to the first ACS routine.
  • AFTER: The ACS read-write variables (data class, storage class, management class, and storage group) are displayed once the last ACS routine has completed.
  • BOTH: Both types of variables are displayed.
Tip: Normally, the first two parameters should be specified as ACSTRACE=(YES,BOTH).

Third positional parameter

The third parameter (SCDS, SCDSBOTH, SCDSONLY) is optional and is used to perform alternate ACS routine tracing.

  • SCDS : If SCDS is specified as the third parameter (for example, ACSTRACE=(YES,BOTH,SCDS)), the SMSDEBUG trace output will display the ACS variables and ACS logic as performed by the alternate ACS routines. After the alternate ACS routines have been traced, the regular, active ACS routines will run and will be used to allocate the dataset.
    Note: Executing the active ACS routines after the alternate ACS routines have been executed allows the allocation to complete successfully even if the alternate ACS routines contain logic errors or assign class names that do not exist in the active configuration.
  • SCDSBOTH : If SCDSBOTH is specified (for example, ACSTRACE=(YES,BOTH,SCDSBOTH)), the SMSDEBUG output trace will reflect, first, the ACS variables and ACS logic as performed by the alternate ACS routines, and second, the actual ACS variables and logic from the active CDS used to allocate the dataset.
    Note: Specifying SCDSBOTH is identical to specifying SCDS, except that the actual ACS routines used to allocate the dataset are also traced.
  • SCDSONLY : If SCDSONLY is specified (for example, ACSTRACE=(YES,BOTH,SCDSONLY)), the SMSDEBUG trace output will display the ACS variables and ACS logic as performed by the alternate ACS routines. The ACS routines in the active configuration will not be executed.
    Warning: If the alternate ACS routines contain a logic error or assign class names that are not in the active configuration, the allocation may fail.