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-TEST-OPTIONS

&pagelevel(3)&pagelevel

Display task-specific settings for testing and diagnostics

Component:

AIDSYSA

Functional area:

Program control

Domain:

PROGRAM

Privileges:

all privileges bar OPERATING

Function

The SHOW-TEST-OPTIONS command displays the test options set with the MODIFY-TEST-OPTIONS command. Optionally context information is also displayed on settings in the user entry and in system parameters which are relevant to testing and on the number of user/area dumps created for the task (see the CONTEXT-INFORMATION operand).

Privileged functions

The privileged user (TSOS privilege) can access tasks of foreign user IDs and password information for foreign tasks. The optional context information also contains privileged system parameters and cross-system information on the system dumps generated.

Format

SHOW-TEST-OPTIONS                                                                                                 

Alias: SHTSO

TASK-IDENTIFICATION = *OWN / *TSN(...) / *TID(...)


*TSN(...)



|

TSN = <alphanum-name 1..4> / <c-string 1..4>


*TID(...)



|

TID = <x-text 5..8>

,INFORMATION = *ALL /

list-poss(4): *PRIVILEGE / *USERDUMP-OPTIONS / *AUDIT / *OWN-UID-DEBUGGING

,PASSWORD-INFORMATION = *SUMMARY / *FULL(...)


*FULL(...)



|

DEBUG-PASSWORD = *NONE / <c-string 1..8>

,CONTEXT-INFORMATION = *NO / *YES

Operands

TASK-IDENTIFICATION = *OWN / *TSN(...) / *TID(...)
Identifies the task whose test options are to be displayed.
Only a privileged user (TSOS privilege) can also specify tasks of foreign user IDs.

TASK-IDENTIFICATION = *OWN
The test options of the local task are to be displayed.

TASK-IDENTIFICATION = *TSN(...)
The task is determined by specifying its task sequence number (TSN).

TSN = <alphanum-name 1..4> / <c-string 1..4>
TSN of the selected task. When <alphanum-name 1..4> is specified, the specified value is, if necessary, filled on the left with zeros. When <c-string 1..4> is specified, the specified value is filled on the left with zeros.

TASK-IDENTIFICATION = *TID(...)
The task is determined by specifying its task ID (TID).

TID = <x-text 5..8>
TID of the selected task. The specified value is, if necessary, filled on the left with zeros.

INFORMATION = *ALL / list-poss(4): *PRIVILEGE / *USERDUMP-OPTIONS / *AUDIT / *OWN-UID-DEBUGGING
Determines the output blocks of the summary information. When a list is specified, output takes place in the specified order. Repeated specifications are ignored.

INFORMATION = *ALL
All settings which can be specified using the MODIFY-TEST-OPTIONS command are displayed.

INFORMATION = *PRIVILEGE
All settings which can be specified in the PRIVILEGE operand of the MODIFY-TEST-OPTIONS command are displayed.

INFORMATION = *USERDUMP-OPTIONS
All settings which can be specified in the USERDUMP-OPTIONS operand of the MODIFY-TEST-OPTIONS command are displayed.

INFORMATION = *AUDIT
All settings which can be specified in the AUDIT operand of the MODIFY-TEST-OPTIONS command are displayed.

INFORMATION = *OWN-UID-DEBUGGING
All settings which can be specified in the OWN-UID-DEBUGGING operand of the MODIFY-TEST-OPTIONS command are displayed.

PASSWORD-INFORMATION = *SUMMARY / *FULL(...)
Determines the output of passwords when INFORMATION=*OWN-UID-DEBUGGING.

PASSWORD-INFORMATION = *SUMMARY
An overview is displayed. Individual passwords for OWN-UID-DEBUGGING are not displayed.

PASSWORD-INFORMATION=*FULL(...)
All passwords for OWN-UID-DEBUGGING are to be displayed.

The nonprivileged user is shown the passwords only if his/her own task is selected and a password is specified in the DEBUG-PASSWORD operand which matches one of the passwords defined in the MODIFY-TEST-OPTIONS command (ACCEPT- or ENABLE-ACCESS operand).

DEBUG-PASSWORD = *NONE / <c-string 1..8>
Specifies a DEBUG password for the task.
The default *NONE means that no password is specified: Only a privileged user (TSOS privilege) requires no password, or in this case any password entered is ignored.

CONTEXT-INFORMATION = *NO / *YES
Determines whether additional information is to be displayed which goes beyond the information of the
MODIFY-TEST-OPTIONS command.

CONTEXT-INFORMATION = *NO
No additional information is to be shown.

CONTEXT-INFORMATION=*YES
Additional information, some of which depends on the TSOS command privilege, is to be displayed (see output format on "Context information for nonprivileged users").

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

Command executed successfully


1

IDA0300

Syntax error


32

CMD0221

System error


64

CMD0216

Error: command privilege missing


64

IDA0301

Semantic error

Output formats

All numerical specifications in the display are hexadecimal.

Summary information

/show-test-options task-id=*own,information=*all

PRIVILEGE: -------------------------------------------------------------
  current: (READ = 1, WRITE = 1)
USERDUMP-OPTIONS: ------------------------------------------------------
  DUMP           = *SYSTEM          DATA-IN-VIRTUAL     = *STD
  DATA-SPACES    = *NO              MEMORY-MAP          = *YES
  OUTPUT-PUBSET  = *DEFAULT-PUBSET  SUPPRESS-DUPLICATES = *YES
  MAXIMUM-NUMBER = *UNLIMITED
AUDIT: -----------------------------------------------------------------
  HARDWARE-AUDIT = *ALLOWED         LINKAGE-AUDIT       = *NOT-ALLOWED
OWN-UID-DEBUGGING: -----------------------------------------------------
  ACCEPT-ACCESS  = *NO              PASSWORD            : n/a
  ENABLE-ACCESS  = *YES             PASSWORD            : given,2

The names correspond to the operand names and values of the MODIFY-TEST-OPTIONS command. The display of the individual information blocks depends on the specifications in the INFORMATION operand.

Key for password display:

n/a

Not applicable (value does not exist)

none

A password is not required

given

No existing password is displayed

given,n

n existing passwords are not displayed (n = 1..8)

Task information

/show-test-opt task-id=*tsn(tsn=snap),information=*privilege

TSN            = |SNAP|           TID                 = 00010019 ——————  (1)
PRIVILEGE: -------------------------------------------------------------
  current: (READ = 0, WRITE = 0)

(1)

Outputs for a task other than a user's own task are introduced with the TSN and TID of the selected task.

Information on passwords

/show-test-opt task-id=*own,information=*own-uid-debug,debug-pass='hugo'

OWN-UID-DEBUGGING: -----------------------------------------------------
  ACCEPT-ACCESS  = *NO              PASSWORD            : n/a
  ENABLE-ACCESS  = *YES             PASSWORD            = |HUGO    |
  ENABLE-ACCESS  = *YES             PASSWORD            = |EMILHANS

If the required authorization is available, existing ACCEPT and ENABLE passwords are displayed. The order of the ENABLE passwords is the reverse of the chronological order in which they were entered using the MODIFY-TEST-OPTIONS command. In other words, the most recent password is output first. 

Context information for nonprivileged users

/show-test-opt task-id=*own,information=*all,context-info=*yes

PRIVILEGE: -------------------------------------------------------------
  current: (READ = 1, WRITE = 1)    MODIFICATION        = *UNCONTROLLED   (1)
  maximal: (READ = 8, WRITE = 2)
  Cl2-opt: (READ = 9, WRITE = 9)
USERDUMP-OPTIONS: ------------------------------------------------------
  DUMP           = *SYSTEM          DATA-IN-VIRTUAL     = *STD
  DATA-SPACES    = *NO              MEMORY-MAP          = *YES
  OUTPUT-PUBSET  = *DEFAULT-PUBSET  SUPPRESS-DUPLICATES = *YES
  MAXIMUM-NUMBER = *UNLIMITED
  # user dumps   = 007E ———————————————————————————————————————————————  (2)
  Cl2-options:
  DUMPCL5P       = 01               DUMPSEPA            = 04
AUDIT: -----------------------------------------------------------------
  HARDWARE-AUDIT = *NOT-ALLOWED     LINKAGE-AUDIT       = *NOT-ALLOWED
    USER-ATTR    : *ALLOWED           USER-ATTR         : *NOT-ALLOWED    (3)
    CL2-option   : not allowed        CL2-option        : not allowed
    HSI-CFCS     : not availabe       HSI-CFCS          : available
OWN-UID-DEBUGGING: -----------------------------------------------------
  ACCEPT-ACCESS  = *NO              PASSWORD            : n/a
  ENABLE-ACCESS  = *YES             PASSWORD            : given.2

A nonprivileged user obtains the following additional information with CONTEXT-INFO=*YES:

(1)

In the PRIVILEGE output block:

  • Modification mode and maximum values for the test privilege according to the user entry.
    See SHOW-USER-ATTRIBUTES command, output fields READ-PRIVILEGE,
    WRITE-PRIVILEGE     and MODIFICATION, grouped under TEST-OPTIONS.

  • Maximum values for the test privilege according to system parameters (Cl2-opt) RDTESTPR and WRTESTPR

(2)

In the USERDUMP-OPTIONS output block:

  • Number of user/area dumps generated in the task

  • The values for the nonprivileged system parameters for CDUMP are displayed under Cl2-options.

(3)

In the AUDIT output block:

  • USER-ATTR displays the permission for linkage/hardware audits according to the user entry. See SHOW-USER-ATTRIBUTES command, output fields LINKAGE-AUDIT and HARDWARE-AUDIT, grouped under AUDIT.

  • CL2-option displays the permission for linkage/hardware audits according to the system parameter (Cl2-option) AUDALLOW

  • HSI-CFCS displays the availability of linkage/hardware audits according to the hardware/software interface (HSI)

Context information for users with TSOS privilege

/show-test-opt task-id=*own,information=*all,context-info=*yes

PRIVILEGE: -------------------------------------------------------------
  current: (READ = 1, WRITE = 1)    MODIFICATION        = *UNCONTROLLED   (1)
  maximal: (READ = 8, WRITE = 2)
  Cl2-opt: (READ = 9, WRITE = 9)
USERDUMP-OPTIONS: ------------------------------------------------------
  DUMP           = *SYSTEM          DATA-IN-VIRTUAL     = *STD
  DATA-SPACES    = *NO              MEMORY-MAP          = *YES
  OUTPUT-PUBSET  = *DEFAULT-PUBSET  SUPPRESS-DUPLICATES = *YES
  MAXIMUM-NUMBER = *UNLIMITED
  # user dumps   = 007E (task)      # system dumps      = 0000 (task)     (2)
  # autom. SD's  = 0000 (system)    # system dumps      = 0000 (system)
  Cl2-options:
  DUMPCL5P       = 01               DUMPSEPA            = 04
  DUMPCTRL       = 0F               DUMPSD#             = FF
  DUMPSREF       = 01               SNAPTIME            = 0018
AUDIT: -----------------------------------------------------------------
  HARDWARE-AUDIT = *NOT-ALLOWED     LINKAGE-AUDIT       = *NOT-ALLOWED
    USER-ATTR    : *ALLOWED           USER-ATTR         : *NOT-ALLOWED    (3)
    CL2-option   : not allowed        CL2-option        : not allowed
    HSI-CFCS     : not availabe       HSI-CFCS          : available
OWN-UID-DEBUGGING: -----------------------------------------------------
  ACCEPT-ACCESS  = *NO              PASSWORD            : n/a
  ENABLE-ACCESS  = *YES             PASSWORD            : given.2

A privileged user (TSOS privilege) obtains the following additional information with CONTEXT-INFO=*YES:

(1)

In the PRIVILEGE output block:

  • Modification mode and maximum values for the test privilege according to the user entry.
    See SHOW-USER-ATTRIBUTES command, output fields READ-PRIVILEGE,
    WRITE-PRIVILEGE     and MODIFICATION, grouped under TEST-OPTIONS.

  • Maximum values for the test privilege according to system parameters (Cl2-opt) RDTESTPR and WRTESTPR

(2)

In the USERDUMP-OPTIONS output block:

  • Number of user/area dumps and system dumps generated in the task

  • Number of system dumps generated automatically or throughout the system

  • The values for the system parameters for CDUMP and SNAP are displayed under Cl2-options. 

(3)

In the AUDIT output block:

  • USER-ATTR displays the permission for linkage/hardware audits according to the user entry. See SHOW-USER-ATTRIBUTES command, output fields LINKAGE-AUDIT and HARDWARE-AUDIT, grouped under AUDIT.

  • CL2-option displays the permission for linkage/hardware audits according to the system parameter
    (Cl2-option) AUDALLOW

  • HSI-CFCS displays the availability of linkage/hardware audits according to the hardware/software interface (HSI)

For the nonprivileged user, the context information in the USERDUMP-OPTIONS output block also displays information on the system dumps generated automatically and throughout the system and on privileged system parameters.

Powered by Atlassian Confluence and Scroll Viewport.