ASFUSER

Purpose

The ASFUSER command is a file manager command that updates the 40 user fields in the automation status file. The ASFUSER command has different formats depending on whether it is used to:

  • Display multiple records
  • Display, delete, or replace (update) a single record

The ASFUSER command is pipeable.

Syntax

To display single or multiple records use the following syntax:

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

To delete a single record use the following syntax:

Read syntax diagramSkip visual syntax diagramASFUSERREQ=DELID= resource

To replace (update) a record use the following syntax:

Read syntax diagramSkip visual syntax diagramASFUSERREQ=REPLID= resourceUSER n= data1
Notes:
  • 1 n can be a number from 1 through 40

Parameters

REQ
The type of request for automation status file record information the ASFUSER command performs. This value may be one of the following:
Value
Description
DISP
Displays a record in the automation status file. This value is the default if the REQ parameter is not coded.
DEL
Deletes a record in the automation status file.
REPL
Replaces or adds a record in the automation status file.

If this parameter is specified, other parameters that describe the data to be displayed, deleted, or updated must be specified.

FROM
The resource ID that is the starting key when displaying multiple automation status file records. This value can be from 1 through 64 characters long.
TO
The resource ID that is the ending key when displaying multiple records. If not specified, the value defaults to the same key as the FROM parameter. This value can be from 1 through 64 characters long.
ID
The resource ID that is the key to the automation status file record. This ID is the application name for application records. This ID can be from 1 through 64 characters long.
USER1=data–USER40=data
These parameters specify data that is stored in each of the 40 fields in the automation status file that are reserved for your information. All these parameters are optional. The specified data can be 1 through 20 characters long. These parameters are only used with ASFUSER replace requests (REQ=REPL). The data must be enclosed in parenthesis or quotes if it contains blanks or a comma.

Restrictions and Limitations

None.

Usage

If your automation procedure performs a replace or update function, only those fields that need replacing must be specified. No change occurs to other automation status file fields.

Example 1

This example shows a command to create an automation status file record for a resource with a resource ID of DASD.

The ASFUSER command to create the record is: 
ASFUSER REQ=REPL ID=DASD USER1=3390 USER2=SITE1
The response to the ASFUSER command is: 
AOF001I REQUEST "REPLACE" WAS SUCCESSFUL FOR "DASD"

Example 2

This example shows a command to display an automation status file record for DASD.

The ASFUSER command to display the record is: 
ASFUSER ID=DASD
The response to the ASFUSER command is: 
AOF150I STATISTICS DISPLAY REQUESTED FOR DASD THRU DASD
AOF151I ID=DASD , TYPE= N/A , STATUS= N/A
AOF152I LAST UPDATED BY OPERATOR OPER1
AOF158I USER1 = 3390
AOF158I USER2 = SITE1
AOF002I END OF MULTILINE MESSAGE GROUP

Example 3

This example shows a command to update the DASD automation status file record to add a new DASD device type.

The ASFUSER command to add a new field to the existing record is:
ASFUSER REQ=REPL,id=DASD,USER3=3990
The response to the ASFUSER command is: 
AOF001I REQUEST "REPLACE" WAS SUCCESSFUL FOR "DASD"
Note: Other values in record DASD remain as they were before the ASFUSER command was issued.