ASF

Purpose

The ASF command is a file manager command that displays records from the automation status file. The automation status file records are maintained in a VSAM data set. ASF interfaces with the VSAM file to obtain control information that is vital to SA z/OS, such as:

  • Automation status
  • Time and date information for specific events within the lifecycle of an application
  • Whether an error threshold has been exceeded
  • Time and date information for error conditions

You can also use the ASF command to reset occurrences of threshold errors by updating records in the automation status file.

Syntax

To display single or multiple records use the following syntax:

Read syntax diagramSkip visual syntax diagramASFREQ=DISPID= resourceFROM= resourceTO= resource

To reset occurrences of threshold errors use the following syntax:

Read syntax diagramSkip visual syntax diagramASFREQ=REPLID= resourceERRORDT=''THRSHLD=''

Parameters

REQ
The type of request for automation status file information that the ASF command performs. This value may be:
DISP
Displays information in the automation status file. This value is the default if the REQ parameter is not coded.
REPL
Resets a record in the automation status file.
ID
The resource ID that is the key to the automation status file record. This ID is the application name for application records. This value can be from 1 through 64 characters long.
FROM
The resource ID that is the starting key when displaying multiple automation status file records. This resource is the application name for application records. This value can be from 1 through 64 characters long.
TO
The resource ID that is the ending key when displaying multiple automation status file records. If not specified, the value defaults to the FROM parameter value. This resource is the application name for application records. This value can be from 1 through 64 characters long.

If a resource ID is specified, the records that are to be displayed are resolved alphabetically.

ERRORDT
Specify ERRORDT='' THRSHLD='' with REQ=REPL to reset occurrences of threshold errors for a resource.
THRSHLD
Specify ERRORDT='' THRSHLD='' with REQ=REPL to reset occurrences of threshold errors for a resource.

Usage

To modify automation status file fields that are reserved for your data, use the ASFUSER command. See ASFUSER for details.

Error conditions

To display status information about subsystem JES2, enter: 
ASF REQ=DISP ID=JES2
To reset the occurrences of threshold errors for the application APPC, enter: 
ASF ID=APPC REQ=REPL ERRORDT='' THRSHLD=''