Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-ACS-OPTIONS

&pagelevel(3)&pagelevel

Show ACS option settings

Component:

ACS                                                                                                                           

Functional area:

File processing

Domain:

FILE

Privileges:

STD-PROCESSING
ACS-ADMINISTRATION
SAT-FILE-EVALUATION
SAT-FILE-MANAGEMENT
SECURITY-ADMINISTRATION

Function

The SHOW-ACS-OPTIONS command writes the following information on the currently set ACS options of the task to SYSOUT:

  • status of the alias catalog (INACTIVE, ACTIVE or INHOLD)

  • list of all the AC system files and AC files that were loaded since the beginning of the task or since the alias catalog was last deleted

  • number of changes made to the current alias catalog with the ADD-, MODIFY- and REMOVE-ALIAS-CATALOG-ENTRY commands

  • current settings of all ACS options:

    • Message output when the alias catalog is loaded

    • Logging of alias substitution and prefix insertion

    • Permitting catalog and user IDs in the alias (fully qualified)

    • Permitting user IDs in the alias

    • Standard range of alias substitution and prefix insertion (for files and/or job variables)

The command supports structured output in S variables (see "Output in S variables").

Privileged functions

Users with the ACS-ADMINISTRATION privilege can select the SCOPE operand to request details of ACS option settings for the task which is running or of the system-global preset values:

  • the logging of ACS actions

  • the permissibility of catalog and user IDs in alias names

  • the pubset on which temporary SPOOL files are set up.

Format

SHOW-ACS-OPTIONS                                                                                                                                

SCOPE = *TASK / *SYSTEM

Operands

SCOPE =
Only for users with ACS-ADMINISTRATION privilege:
Selects whether the task-local or the system-global default settings are being requested.

SCOPE = *TASK
Preset value: only the options specified for the task currently running are to be displayed.

SCOPE = *SYSTEM
Specifies that all the system-global options should be displayed.

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

Command executed normally

Information output

The output begins with the version of the system component ACS. The following information is then output:

Output field

Meaning

STATUS

Status of the alias catalog (INACTIVE, ACTIVE or IN HOLD)

ACTIVATED ALIAS CATALOG FILE(S):

List of all AC system files and AC files which have been loaded since the start of the task or since the last time the alias catalog was deleted.

  • ID

  • Symbolic name of the AC system file or AC file

  • U-INFO

  • User information specified when saving

  • DESCR

  • Additional information specified when saving

  • DATE

  • Creation date of the AC system file or AC file

  • FILE NAME

  • Path name of the AC system file or AC file

ENTRIES ADDED/MODIFIED BY INDIVIDUAL COMMANDS:

Number of modifications to the current alias catalog made using the ADD-, MODIFY- and REMOVE-ALIAS-CATALOG-ENTRY commands.

LOGGING:

Logging:

  • ALIAS-SUBSTITUTION=

  • when substituting aliases (YES/NO/STD)

  • PREFIX-INSERTION=

  • when inserting a prefix (YES/NO/STD)

SUCCESS-MSG OPTIONS:

Output of a message after successful loading:

  • USER-FILE=

  • for an AC system file (YES/NO)

  • SYSTEM-FILE=

  • for an AC file (YES/NO)

COMPLETE-ALIAS-NAMES

Catalog and user IDs in the alias (fully qualified)

  • ALLOWED (is permitted)

  • NOT-ALLOWED (USER-MODIF=ALLOWED/NOT-ALLOWED)
    Is not permitted; the privileged user can prevent the user-specific modification of this setting

ALIAS-USERID

User IDs in the alias

  • ALLOWED (is permitted)

  • NOT-ALLOWED (USER-MODIF=ALLOWED/NOT-ALLOWED)
    Is not permitted; the privileged user can prevent the user-specific modification of this setting

STANDARD-RANGE

Standard range for substitution of aliases and prefix insertion:

  • FILE (only for files)

  • JV (only for job variables)

  • BOTH (for files and job variables)

Table 86: Output fields for the SHOW-ACS-OPTIONS command

Examples

See the ADD-ALIAS-CATALOG-ENTRY and SET-FILE-NAME-PREFIX commands. 

Output in S variable

The SCOPE operand identifies the S variables which are to be created. The possible values for SCOPE are *TASK and *SYSTEM.

Output information

Name of the S variable

T

Contents                  

Condition

AC file name alias

var(*LIST).ALIAS-CAT-F(*LIST).ALIAS-CAT-ID

S

'BLANK'
*
*OWN
<name 1...20>

SCOPE=
*TASK

AC file creation date

var(*LIST).ALIAS-CAT-F(*LIST).DATE

S

'BLANK'
<yyyy-mm-dd>

SCOPE=
*TASK

Additional information on AC file

var(*LIST).ALIAS-CAT-F(*LIST).DESCRIPTOR

S

'BLANK'
<alphan.-name 1..8>

SCOPE=
*TASK

Actual file name of AC file

var(*LIST).ALIAS-CAT-F(*LIST).F-NAME

S

'BLANK'
*SYS
<filename 1..54>

SCOPE=
*TASK

Additional name for AC file

var(*LIST).ALIAS-CAT-F(*LIST).USER-INFO

S

'BLANK'
<name 1...8>

SCOPE=
*TASK

Output of message ACS0000 each time the alias is substituted

var(*LIST).ALIAS-SUBST

S

*STD
*YES

SCOPE=
*TASK/
*SYSTEM

User IDs allowed in aliases

var(*LIST).ALIAS-USER-ID

S

*ALLOW
*NOT-ALLOW

SCOPE=
*TASK/
*SYSTEM

Changing of user IDs allowed in aliases

var(*LIST).ALIAS-USER-ID-MOD

S

*ALLOW
*NOT-ALLOW

SCOPE=
*TASK/
*SYSTEM

Fully qualified aliases allowed

var(*LIST).COMPL-ALIAS-NAME

S

*ALLOW
*NOT-ALLOW

SCOPE=
*TASK/
*SYSTEM

Changing of ACS option ALIAS-USERID allowed

var(*LIST).COMPL-USER-MOD

S

*ALLOW
*NOT-ALLOW

SCOPE=
*TASK/
*SYSTEM

Number of changes to the alias catalog

var(*LIST).NUM-OF-AC-CMD

I

<integer 0...65535>

SCOPE=
*TASK

Output of message ACS0000 each time a prefix is inserted

var(*LIST).PREFIX-INS

S

*NO
*YES

SCOPE=
*TASK/
*SYSTEM

Security level

var(*LIST).SEC-LEV

S

*HIGH
*LOW
*UNDEF

SCOPE=
*SYSTEM

Pubset for spool file

var(*LIST).SPOOL-F-PUBSET

S

*STD
<cat-id 1..4>

SCOPE=
*SYSTEM

Alias catalog status

var(*LIST).STA

S

*ACTIVE
*IN-HOLD
*INACTIVE
*NOT-AVAIL

SCOPE=
*TASK

Range when replacing the alias or adding a prefix (for files and/or job variables)

var(*LIST).STANDARD-RANGE

S

*FILE
*JV
*BOTH

SCOPE=
*TASK/
*SYSTEM

Message output from ACS0001 to an AC device

var(*LIST).SYS-F-MSG

S

*NO
*YES

SCOPE=
*TASK/
*SYSTEM

Message output from ACS0001 to an AC file

var(*LIST).USER-F-MSG

S

*NO
*YES

SCOPE=
*TASK/
*SYSTEM

Powered by Atlassian Confluence and Scroll Viewport.