Previous Topic: &SECCALL GET

Next Topic: &SECCALL UPDATE


&SECCALL QUERY

Provides the ability to return the security attributes that the user is using in their current region.

&SECCALL QUERY [ PREFIX=prefix ] 
               [ FIELDS={ (nnnn,...,nnnn) | * } ]

Operands:

PREFIX=prefix

Defines a 1- to 7-character prefix of the variables referred to by the FIELDS operand. The default is SEC.

FIELDS={ (nnnn,...,nnnn) | * }

Provides a list of nominated structured field values for which the security attributes for the user ID are to be returned.

Note: For more information about structured fields, see the Security Guide.

A list of structured field values is supplied, or an asterisk (*) is used to specify that all security attributes are to be returned. The variables are set as indicated by the required structured fields and are returned to the NCL procedure in the form &prefixnnnn, where prefix is defined by the PREFIX operand and nnnn is a defined structured field for this system. (For more information about the FIELDS operand, see Structured Fields in this chapter.)

If the FIELDS operand is omitted, then all security attributes are returned.

Return Codes:

The result of the QUERY function sets &RETCODE as follows:

0

Request successful. The user ID attributes are available in the user variables generically named &prefixnnnn.

4

The request was unsuccessful. The &SYSMSG system variable is set to an error message indicating the cause of failure.

Notes:

The query function is issued only by a user logged on to your product region. Default values for all structured fields are returned if the function is issued from EASINET.

There are no calls made to either the native UAMS database or to the external security exit, as the information is obtained from the user's current region.

If a request is made for a structured field that is part of an unlicensed or excluded feature, then the relevant variable is null.

The following structured fields are valid for &SECCALL QUERY:

0010

Current user ID

0014

User language code

0017

User time-out control (Y/N)

0019

Multiple signon capacity (Y/N)

0020

OCS access privilege (Y/N)

0021

Broadcast Services access privilege (Y/N)

0022

Network Services access privilege (Y/N)

0023

System Support privilege (Y/N)

0025

CA SOLVE:FTS access privilege (Y/N)

0026

NEWS access privilege (Y/N)

0027

MAI-FS access privilege (Y/N)

0028

User Services procedure name

0029

User's NCL procedure library

002A

UAMS access privilege (Y/N)

002B

Operations Management privilege (Y/N)

002D

NCS access privilege (Y/N)

002E

User's SPLIT/SWAP privilege (Y/N)

002F

Library Services path name

0030

User's time zone name

0050

OCS command authority level

0051

OCS Monitor status (Y/N)

0055

PPO message receipt option (Y/N)

0057, B

NPF message restriction option (Y/N)

0059

OCS MSG message receipt (Y/N)

005A

OCS unsolicited message receipt (Y/N)

0081

Information Services access (Y/N)

0100

CA SOLVE:FTS definition privilege (P/S/N)

0101

CA SOLVE:FTS private request privilege (Y/N)

0102

CA SOLVE:FTS system request privilege (Y/N)

0103

CA SOLVE:FTS private control privilege (Y/N)

0104

CA SOLVE:FTS system control privilege (Y/N)

0105

CA SOLVE:FTS private function mask (12 characters)

0106

CA SOLVE:FTS system function mask (12 characters)

0150

NEWS statistics reset privilege (Y/N)

0151

NTS access privilege (Y/N)

0180, B

AOM message delivery and routing codes

0181, D

AOM MVS SYSCMD console authority

0182

AOM MSG level (20 characters)

0183, E

AOM VM SYSCMD authority (Y/N)

0185

AOM VOS3/JSS4 SYSCMD authority (0 to 15)

0200

MAI-FS privilege class (A/B/C/D)

0201

MAI-FS model user ID (8 characters)

0202

MAI-FS A and E command capability (Y/N)

0510

Panel command access authority (Y/N)

0511

System services access (Y/N)

0530

TCP/IP Services access privilege (0-2)

0580

CA SOLVE:NetMail access (Y/N)

0601

MODS access (Y/N)