|
Selection of Join entries by userid name characteristics
[col] [-] [p] 'string' Selection based on the occurence of a text string within the name of the userid
col :col: | >:col: | <:col:
:col: Column in which the search string 'string' must begin.
>:col: Search string must appear after the column indicated by :col: .
<:col: Search string must appear before the column indicated by :col: .
- Negative selection: all Join entries whose userid does not contain the string 'string' will be selected.
p > | <
All Join entries whose userids contain a string less than / greater than the search string 'string' .
Standard: = 'string'
'string' Search string for userid.
Generally, the quotes delimiting the search string can be omitted. If the search string begins with the keyword RL, then it must be enclosed in quotes.
Notes:
If no search string is specified in the USER-ID field, then all Join entries whose characteristics fulfill the criteria specified in the other fields of the Selection mask will be selected.
Transmitting an empty Selection mask will cause the selection of all Join entries from all available online Pubsets.
Examples:
UTM
Userids which contain the string 'UTM' .
:1:<'D'
Userids must begin with the letters A, B or C (characters <'D').
Complex selection: param [op param] [op param] .....
param Simple search argument conforming to the above syntax.
op Boolean operator linking the two search arguments.
, Or operator.
+ And operator.
* [n] Wildcard operator: And operator, but the second string must additionally occur after the first string in the userid. If a value is specified for n, then exactly n characters must be between the first and second strings.
Any number of Or/And/Wildcard conditions can be combined.
Additional options for entering complex selection criteria can be found in the CFS User Manual, described in the FILENAME-SELECT field section.
Examples:
FHS,IFG,UTM
All userids containing at least one of the strings 'IFG', 'FHS' or 'UTM' .
:1:'TT'*'X'
All userids whose names both begin with 'TT' and contain the letter 'X' somewhere else.
The selection will be performed using the values stored in the specified Parameter Set.
%name Name of the Parameter Set containing the selection criteria.
%? All relevant parameter sets will be displayed. Marking the required parameter set will cause it to be selected.
jrsave Name of the JRSAVE file in which the Parameter Set is stored.
Standard: CFS.JRSAVE.xxxx. For further information, see the CFS User Manual, Chapter 27 ("Files created by CFS").
? The Selection mask will be pre-filled with the contents of the Parameter Set and presented for the user to amend if required. Normally the selection process is executed immediately.
Note:
Saving selection criteria from a Join list can be achieved with the command SP %name. For further information, see the CFS User Manual, Chapter 7: Command SP.
user-id , Q Qualified Selection. The Join entries of the userid as specified will be selected. The fully-qualified userid must be entered without the preceding $ or the trailing full stop.
Using the Q option will speed up the selection of Join entries for a specific userid considerably.
RL The last Join list to have been displayed will be restored to the screen.
NO [; cmd] No Join entries will be selected. The next mask to be displayed will consist solely of the JES Command field (COMMAND).
cmd Automatic input for COMMAND field. The specified string will be interpreted as a JES command and executed immediately.
Selection mask : PVS
Public Volume Set of the Join entry
pvs Selection of Join entries on Pubsets designated pvs. The PVS identifier must be entered without the delimiting colons.
The local (and hence available) Pubsets are displayed in the Status line (line 25).
pvs1,pvs2,... Multiple Pubsets can also be specified.
-pvs Selection of all Join entries on Public Volume Sets other than pvs.
Selection mask : DEFCAT
Selection according to the Default Pubset of the Join entries
pvs Those Join entries whose Default Pubset is that specified as PVS will be selected.
-pvs Those Join entries whose Default Pubset is not that specified as PVS will be selected.
As in the PVS field, the values should be entered without delimiting colons, e.g. A, ABCX.
The Default Pubset identifies the Cat-ID which will be used if the user accesses files or Job variables without explicitly specifying a Cat-ID. The Default Cat-ID will always be taken from the Join entry of the current Home Pubset of the user. The Home-Pubset is displayed in the Status line (line 25).
Selection mask : PUBSPACE-LIMIT
Selection according to Pubspace Limit
>x | =x | <x All Join entries for which the user is allowed to reserve more than (>), less than (<), or exactly (=) x PAM pages of public space will be selected.
The '=' sign can be omitted. Specifying a value without an operator will be interpreted as =x .
Note: The value for the PUBSPACE-LIMIT field can also be specified with the abbreviation PUB-L in procedures and in the NP/AL command (e.g. NP PUB-L<10000).
Examples:
<1677215 All Join entries whose Pubspace limit differs from the default maximum value will be selected.
0 All Join entries whose users may not create files on a Pubset will be selected.
Selection mask : PUBSPACE-USED
Selection according to utilised Pubspace
>x | =x | <x All Join entries for which the user has reserved more than (>), less than (<), or exactly (=) x PAM pages of public space will be selected.
The '=' sign can be omitted. Specifying a value without an operator will be interpreted as =x .
Note: The value for the PUBSPACE-USED field can also be specified with the abbreviation PUB-U in procedures and in the NP/AL command (e.g. NP PUB-U=0).
Examples:
>10000 Select all Join entries for all Pubsets and userids for those users who have used more than 10000 PAM pages.
0 Select all Join entries for all Pubsets and userids for those users who have not used any public space at all.
Selection mask : ADDRSP
Selection according to maximum user address space
>x | =x | <x All Join entries will be selected for those users allowed more than (>), less than (<), or exactly (=) x megabytes of user address space (Class 6 memory).
The '=' sign can be omitted. Specifying a value without an operator will be interpreted as =x .
Example:
>8 Select all Join entries whose users are allowed more than 8 megabytes of Class 6 memory.
Selection mask : SEVER
Selection of all severed Join entries
Y All Join entries will be selected for which the system administrator has blocked user access to the system by means of a SEVER ,SET or LOCK-USER command.
N All Join entries will be selected for those users not being prevented from issuing a LOGON command.
Selection mask : PASSWORD
Selection of all Join entries protected with a password
Y Select all Join entries protected with a logon password.
N Select all Join entries without a logon password.
Selection mask: SORT OPTION
Specify Sort criteria for Join list
The Join list is normally sorted in ascending userid order. The SORT OPTION allows another field from the Join list to be specified as the sort criterion. The sort sequence (ascending or descending) can also be specified.
[NONE | ADDR[SP] | DEFC[AT] | PUB[SPACE]-L | PUB[SPACE]-U | PVS | USER-ID | USER | (col,len)| header ] [, A | D ]
NONE The Join list will be displayed without first being sorted. This option is relevant if the sorting of a large number of userids and account numbers is to be avoided.
ADDRSP The Join list will be sorted according to the ADDRSP field (max. allowable Class 6 memory). ADDR can be specified instead of ADDRSP.
DEFCAT The Join list will be sorted according to the Default-Pubset. DEFC can be specified instead of DEFCAT.
PUBSPACE-L The Join list will be sorted according to the PUBSP-L (Pubspace-Limit) field. PUB-L can be specified instead of PUBSPACE-L.
PUBSPACE-U The Join list will be sorted according to the PUBSP-U (Pubspace-Used) field. PUB-U can be specified instead of PUBSPACE-U.
PVS The Join list will be sorted by PVS and then by userid.
USER-ID The Join list will be sorted by userid (Default).
USER The Join list will be sorted by to the contents of the User Option field (right column).
(col,len) The Join list will be sorted according to the column col across a length of len in the table entry.
header The Join list will be sorted according to the column defined in the header.
A Ascending sort order (default).
D Descending sort order.
Default: If nothing is specified in the SORT OPTION field, then the Join list will appear sorted in ascending userid order. The Pubsets within the userid will appear in the order they are displayed in line 25.
The User Options described below provide the user with the means for displaying user-selectable characteristics in the Join list, in addition to the default display. Parameters can also be specified for those characteristics selected.
If nothing is specified in the USER OPTION field, then by default the ENF (Enforce=Yes/No) attribute will be displayed.
The USER OPTION field can also be used to control the type of Join list displayed (see page ).
Account-specific Join list:
User Options ACCNB, CLASS, EXP, INHD, NTL, PRI, TIME, TTYPL.
Amount-specific Join list: User Option AMOUNT.
Mail-specific Join list: User Option MAIL.
SDF-specific Join list: User Option SDF.
Pubspace-specific Join list: User Option SPACE.
Space-specific Join list: User Option SPACE-ALL.
User-specific Join list: all other User Options.
Note:
For all selection parameters corresponding to the >x | <x | =x format, the = sign can be omitted. If the value x is entered on its own, the = sign will be inserted automatically.
#ACC Number of Account numbers. This User Option displays the total number of Account numbers associated with this Join entry. BS2000 V11 is a prerequisite for the #ACC User Option.
Selection parameter: >x | <x | =x
#FILE Number of Files. This User Option displays the total number of files cataloged under this userid and PVS. BS2000 V11 is a prerequisite for the #ACC User Option.
Selection parameter: >x | <x | =x
#JV Number of Job variables. This User Option displays the total number of Job variables cataloged under this userid and PVS.
Selection parameter: >x | <x | =x
ACC[NB] Account Numbers. This User Option causes the Account-specific Join list (see page ) to be displayed. One or more Account numbers can be specified as selection parameters.
Selection parameter: acct-# [, acct-# ] ...
One or more search parameters can be specified instead of full Account numbers (see Selection mask, USER-ID field, page ).
AMOUNT The Amount-specific Join list (see page ) will be displayed. This list will display the maximum permissable number of files/Job variables, the number of files/Job variables already allocated, and the difference between them. BS2000 V11 is a prerequisite for the AMOUNT User Option.
Selection parameter: none
AUDIT Access control for files by means of System-Exits.
This User Option determines whether the user may utilise the AUDIT operand in the CATALOG command for files. The AUDIT operand allows access to the file to be monitored by means of System-Exit routines. For further information, refer to the "Command Language" or "DVS" manuals.
Selection parameter: Y | N
CCS Coded Character Set. BS2000 V11 is a prerequisite for this User Option, and will display the name of the Coded Character Set (one to eight characters) with which the files of this PVS will normally be processed. The Modify-File-Attributes command allows a non-standard Character Set to be used for any file.
Selection parameter: string (fully-qualified name of a CCS)
CLASS Spoolout Class for Account number. This User Option will cause the Account-specific Join list (see page ) to be displayed. The User Option will display the Spoolout Class of each Account number.
Selection parameter: >x | <x | =x (0 <= x <= 255)
CSTMP This User Option indicates whether or not the user is allowed to use CSTMP macros in programs. The CSTMP macro enables a Memory Pool to be set to READ ONLY . For further information, refer to the "Executive Macros" manual.
Selection parameter: Y | N
DEF-MSG-L The default setting for the system messages language will be displayed for the userid: German / English / global system language setting. The setting can be changed by using the Action Code M (Modify), and then overwriting the value as required. The ONXMOD-USER DEF-MSG-L=[D|E] Variable Action can be used to modify the default language settings for multiple Join entries.
Selection parameter: D | E | *STD
DMS[-TUNING] BS2000 V11 is a prerequisite for this User Option, and indicates whether, and to what extent, the user is allowed to use priority resources (e.g. resident ISAM Pools, FAST-PAM Environment, PERFORMANCE=HIGH|V-HIGH file attributes).
Selection parameter: C[ONCURRENT] | E[XCLUSIVE] | N[ONE]
ENF Action to be taken when user exceeds Public space allocation.
Y The user may exceed the public space allocation.
N The user may not exceed the public space allocation.
T The user may exceed the public space allocation, but only during the current session.
This attribute will be displayed by default if the User Option field is left empty.
Selection parameter: Y | N | T
EXP Authorisation for Account numbers to start Enter jobs with the EXPRESS parameter. The EXPRESS parameter causes the job to be started immediately. Specifying this User Option will cause the Account-specific Join list to be displayed (see page ).
Selection parameter: Y | N
FILE-D[IFF] BS2000 V11 is a prerequisite for this User Option, which displays the difference between FILE-LIM and the number of files already created.
Selection parameter: >x | <x | =x
FILE-L[IM] BS2000 V11 is a prerequisite for this User Option, which indicates how many files the user is allowed to create on the specified PVS.
Selection parameter: >x | <x | =x
FSHARE User Access to a Public Volume Set.
This User Option provides information on whether the user is permitted access to a particular Pubset or not.
Selection parameter: pvs | -pvs
pvs All userids which have access to this particular PVS.
-pvs All userids which do not have access to this particular PVS.
Notes:
The FSHARE User Option is only relevant if the access protection to Pubsets is not switched off at system generation time (Class 2 System parameter FSHARING = 1). For further information, see the "System Generation" manual.
If the FSHARE User Option is combined with specifying a PVS-ID of a Standby Pubset in the PVS field, the result will be a simulation of those userids which would have access to that particular Pubset in the Standby event taking place.
GROUP This User Option indicates the User Group to which the Join entry belongs.
Selection parameter: group | srch
group is the fully-qualified description of a User Group.
srch can be a simple or complex search string as described fully on page (Selection mask: USER-ID Field).
INF Any INF text for this Join entry ?
This User Option indicates whether an entry exists in any of the JES Information Catalog for this Join entry, and, if so, what format. (See Action Codes I/IM, page ).
Selection parameter: [Y | N] [, FORM=xxx] [, 'string']
Y | N Inf-Text present ? Yes/No
FORM=xxx Selection according to the storage format used.
'string' Select all Join entries whose Inf-text contains the specified search string.
Notes:
If the FORM= parameter or a search condition is specified, the Y selection parameter will be inserted automatically, and need not be entered by the user.
More than one selection parameter can be specified. The individual parameters should be separated by commas.
INF FORM=SX0,'UTM' for example will select all Join entries which have some information conforming to the user-defined screen format SX0. In addition, the Inf-text must contain the string 'UTM' . Upper-/lowercase is not checked.
INHD Inhibit Deactivation for Account Number.
This User Option indicates whether or not a deactivation block (by means of the TINF macro) is allowed for a task running under this Account number. For further information, see the "Executive Macros" manual. Specifying this User Option will display an Account-specific Join list (see page ).
Selection parameter: Y | N
JOBCL[ASS] This User Option will cause all the allowable Job classes for the Home pubset userids to be displayed in a Job class list. The JOBCL User Option is available from OSD V3.0. See page for Action Codes which are permitted in the Job class list.
Selection parameter: [ srch] [, U= D|A ] [, J= B|D ]
srch represents a simple or complex search string, which is described in more detail on page (Selection mask: USER-ID field).
Only those Job classes whose names fulfill the search criteria will appear in the list.
U= D | A
All Job classes with the attribute USAGE=Default|Allowed will be selected.
J= D | B
All Job classes with the attribute JOBS=Dialog|Batch will be selected.
JV-D[IFF] BS2000 V11 is a prerequisite for this User Option which will display the difference between JV-LIM and the number of Job variables already cataloged.
Selection parameter: >x | <x | =x
JV-L[IM] BS2000 V11 is a prerequisite for this User Option, which indicates the maximum number of Job variables which may be created on the PVS by the user.
Selection parameter: >x | <x | =x
MAIL Mail Address for Spoolout listings. This User Option will cause the Mail-specific Join list (see page ) to be displayed. The text associated with the MAIL= operand will be displayed for each Join entry. This text is that which is printed on the first page of every Spoolout listing.
Selection parameter: srch
srch represents a simple or complex search string, as described fully on page (Selection mask: USER-ID Field).
Example:
MAIL L'Box 114','DEPT 1'
Select all Join entries whose Mail addresses contain the text strings 'Box 114' or 'DEPT 1' .
Notes:
A 1 byte Action field can be displayed in a Mail-specific Join list, either by setting a default value in the JESMAIN module, or by means of a SET MAIL-ACTION-CODE=Y command. The codes C (Copy) and O (Overwrite) can be used in a similar fashion to EDT in order to copy Mail addresses.
C will result in the contents of the Mail address being copied to the internal copy buffer, which can then be used to overwrite the Mail address contents of any userid.
C Copy. Copy Mail address to copy buffer.
O Over. Insert contents of copy buffer as a Mail address for this userid. The contents of the copy buffer will not be cleared down after the execution of this command, unlike in EDT.
When processing the Mail addresses the following commands are relevant: LOW, M, M, item1=item2 (page ff.), SET MAIL-TABS, SET MAIL-ACTION-CODE, SET M'...' (page ff.)
NTL No Time LIMIT for Account number allowed ?
This User Option indicates whether or not Enter jobs can be started without any time limit (TIME=NTL) , under this Account number. Specifying this User Option will cause the Account-specific Join list to be displayed (see page ).
Selection parameter: Y | N
PASS This User Option will display the LOGON password for the individual userids. Specifying a particular password as the selection parameter will result in those userids having exactly that LOGON password being selected.
Selection parameter: srch
srch represents a simple or complex search string, as described fully on page (Selection mask: USER-ID field).
Note: Selecting all userids issued with a password can be achieved through the PASSWORD selection field.
Examples:
PASS C'HUGO'
PASS X'AFFE',C'AFFE',X'531209'
All Join entries possessing a logon password of X'AFFE', C'AFFE' or X'531209' will be selected.
PSWORD Modification of the Logon password by user.
This User Option indicates whether or not the user may modify his/her own LOGON password. The PSWORD command enables the user to create, modify and delete the password. The Join entry can be used to restrict the user to the following rights:
YES The user may create, modify or delete the LOGON password.
MOD The user may modify the password.
NO The user may not create, modify or delete the password.
Selection parameter: Y | M | N
PRI Minimum permissable priority for Account number.
This User Option indicates the minimum (best) permissable Task-Scheduling priority which the user may assign with the PRI[ORITY] command. Specifying this User Option causes the Account-specific Join list to be displayed (see page ).
Selection parameter: >x | <x | =x (30 <= x <= 255)
PRIVSP[ACE]-U[SED] Number of PAM pages used on private volumes on this PVS-ID by the user.
Selection parameter: >x | <x | =x
PUB[SP]-D Difference between Pubspace-LIMIT and Pubspace-Used.
This User Option displays the amount of free public space available to the user on this Pubset.
Selection parameter: >x | <x | =x
Example:
NP PUB-U>0;PUB-L>0;U=PUB-D<1000
With this command, entered in the COMMAND field of the Join list, all Join entries for which the available Pubspace does not exceed 1000 PAM pages will be selected. PUB-U>0 and PUB-L>0 will ensure that only those Join entries which have a Pubspace-LIMIT > 0 and which have used some actual space will be selected.
The same selection can be achieved from the Selection mask by entering the value >0 in the PUBSPACE-LIMIT and PUBSPACE-USED fields, and PUB-D<1000 in the USER OPTION field.
RES-PAGES | RPAG Maximum number of pages resident in memory, and available to the userid.
Selection parameter: >x | <x | =x
SDF Display SDF Group Syntax file. This User Option will cause the SDF-specific Join list (see page ) to be displayed. For each Join entry the SDF profile allocated with the COMMANDS= operand will be displayed.
Selection parameter: srch
srch represents a simple or complex search string, as described fully on page (Selection mask: USER-ID field).
Example:
SDF SYS-TSOS
All Join entries which have the profile SYS-TSOS linked to the SDF Group Syntax file $TSOS.SYS.SDF.GROUP.SYNTAX.TSOS will be selected.
SPACE The Pubspace-specific Join list (see page ) will be displayed. The values for Pubspace-Limit, Pubspace-Used, Pubspace-Difference, as well aa those for Tempspace-Limit and Tempspace-Used will be displayed. Each of these individual values has its own User Option.
Selection parameter: none
SPACE% This User Option will display the percentage utilisation of a Pubset by the individual userids. For the format of the Pubspace-specific percentage list, see page .
The list will contain the following values for the individual userids: (%U/LIM), which represents the percentage value of Pubspace Used compared to the Pubspace Limit, (%U/PVS) which is Pubspace Used compared to the total Pubspace available on the Pubset, and (%LIM/PVS) which is the Pubspace Limit of the userid compared to the total Pubspace available. The last line of the screen will contain the total values for %U/PVS and %LIM/PVS . This list indicates the degree of utilisation of a PVS according to the values in the individual Pubspace-Limit entries.
Selection parameter: none
SPACE-ALL The Space-specific Join list (see page ) will be displayed. The values for Pubspace Used, Tempfile Space, Private Volume Space Used, Total Space Used, as well as the number of files on Public and Private volumes will be displayed. Privspace Used has its own User Option (PRIVSP-U).
Selection parameter: none
TEMP[SP]-D[IFF] BS2000 V11 is a prerequisite for this User Option, which indicates the difference between TEMPSP-LIM and TEMPSP-USED.
Selection parameter: >x | <x | =x
TEMP[SP]-L[IM] BS2000 V11 is a prerequisite for this User Option, which indicates how many PAM pages are available under this userid for temporary files.
Selection parameter: >x | <x | =x
TEMP[SP]-U[SED] BS2000 V11 is a prerequisite for this User Option, which indicates how many PAM pages have currently been used by this userid for temporary files.
Selection parameter: >x | <x | =x
TESTPRIV Test Privilege for AID/TAM Macro.
This User Option indicates which Test Privelege level the user may invoke for use with particular AID functions, or with TAM macros. The Test Privilege level is represented by a value from 1 to 8 for read access to various system tables, and an equivalent value for write access. A higher value represents more privileged access.
The standard Test Privilege of a user is (1,1), i.e. the lowest read and write level. These values can be changed by the user by means of the OPTION command ( OPTION TESTPRIV =(m,n) ).
The Join entry can be used to determine whether the amendment to the level will merely be displayed on the console, or whether it must be approved by the operator before becoming effective.
The output from this User Option is analogous to the TESTPRIV= operands in the JOIN-Command: (m,n,xxx). m = read privilege, n = write privilege, xxx = YES | NO (modification of the privilege only with the consent of the operator at the console).
Selection parameter: [ R >|<|= m ] [ , W >|<|= n ] [ , Y | N ]
Examples:
TESTPRIV R=8,W<3
All Join entries from which the user can modify their read privilege up to 8, and their write privilege less than 3 (by means of the OPTION TESTPRIV command) will be selected.
TESTPRIV R=8,W<3,N
All Join entries with a maximum read privilege of 8, a maximum write privilege of less than 3, and which do not require operator approval from the console when amending their privilege level (by means of the OPTION TESTPRIV command) will be selected.
TIME Maximum CPU time still available under this Account number. Specifying this User Option will cause the Account-specific Join list (see page ) to be displayed.
Selection parameter: >x | <x | =x (0 <= x <= 65535)
TPIGNORE Error messages when checking tape labels.
This User Option indicates whether the operator may ignore messages relating to the mounting of incorrectly-labelled tapes for users. The User Option will display the following:
NO Error messages may not be ignored by the operator.
YES Error messages relating to output files on tape may only be ignored by the tape owner or the system administrator.
READ Error messages relating to input files on tape may be ignored.
BLP No label check for tapes which have been opened in READ or INPUT mode.
ALL All error messages relating to tape label checks may be ignored.
For a full description of the TPIGNORE function, see the "System Administration" manual, JOIN (MODIFY-USER-ATTRIBUTES) command.
Selection parameter: Y | N | R | B | A
TTYPL Categories under which Tasks may run.
This User Option indicates the Categories under which Tasks may run. The Categories available depend on the Account number specified by the user in the LOGON command. Specifying this User Option will cause the Account-specific Join list (see page ) to be displayed. The User Option will display the following:
STD Batch and Dialog Tasks are permitted.
TP Batch, Dialog and Transaction Tasks are permitted.
SYS All Task types are permitted.
Selection parameter: STD | TP | SYS
The User Options described below will result in the display of a Logon Protection characteristic. The format of the output list is described on pages to .
ACCESS The authorisation to logon to the userid in Dialog, Batch or Remote Batch mode will be displayed.
The display DBR implies, for example, that a logon is allowed in Dialog, Batch and Remote Batch mode.
D-- implies that a logon may only be effected to the userid in Dialog.
Selection parameter:
dbr
d D|-|*|$ Logon in Dialog allowed/not allowed/not relevant/protected by Guard
b B|-|* Logon in Batch allowed/not allowed/not relevant
r R|-|* Logon in Rbatch allowed/not allowed/not relevant
G[UARD]= Y|N|srch
Y Dialog logon is protected with GUARD
N Dialog logon is not protected with GUARD
srch Simple or complex search string for the GUARD name controlling dialog access. For a full description of the search syntax, see page .
P[ERSON]= Y|N
Y Dialog logon only possible with Personal Logon (/SET-PERSONAL-ATTR)
N Dialog logon without Personal Logon
BAT-U-ACC Batch Caller User-IDs.
Authorisation to logon to a userid in Batch mode from another userid.
The characters UG- indicate, for example, that a logon is allowed from the own userid and from all others in the User Group.
U-- 5 indicates that a logon is allowed from the current userid and additionally 5 other authorised userids.
Selection parameter:
ugoc
u U|-|* Batch-Logon from own userid is allowed/not allowed/not relevant
g G|-|* Batch-Logon from userids in the User Group is allowed/not allowed/not relevant
o O|-|* Batch-Logon from userids not in the User Group is allowed/not allowed/not relevant
c C|-|* Batch logon from CONSOLE is permitted/not permitted/not specified
Y | N | srch
Y Batch-Logon allowed from all userids
N Batch-Logon not allowed from any userids
srch
Simple or complex search string for userids from which a Batch-Logon is allowed. For a description of the syntax for srch, see page .
CHIP[CARD] The list will indicate whether Chipcard protection is in place for the userid.
*NO-PROTECTION indicates that the userid does not require a Chipcard.
The defined Chipcard IDs will be displayed for all those userids with Chipcard protection.
Selection parameter: Y | N | srch
Y Select all userids for which Chipcard protection is defined
N Select all userids for which no Chipcard protection has been defined
srch
Simple or multiple search string for the Chipcard IDs. For a description of the syntax for srch, see page .
G[UARD]= Y|N|srch
Y Batch logon protected with GUARD
N Batch not protected with GUARD
srch Simple or complex search string for the GUARD name controlling the batch access. For a full description of the search syntax, see page .
Note:
Entering an Action Code NPC for an entry in the Logon Protection List will result in all Chipcard IDs defined for this entry being displayed. New IDs can also be added from here. For further information, see page .
EXDATE The date after which a logon to the userid will not be possible will be displayed. If NONE is displayed, it indicates that no Expiry date is defined for the user.
Selection parameter: Y | N
Y Select all userids for which an Expiry date is defined.
N Select all userids without an Expiry date.
>x | <x | =x: Number of days to the Expiry date of the userid.
or >dd. [mm. [yy] ] | <dd. [mm. [yy] ] | =dd. [mm. [yy] ]:
Expiry date after / before / exactly the specified day.
LP A list with the main Logon Protection characteristics will be displayed. The format of the list is described on page .
There are no Selection Parameters for the LP User Option.
LPPSW A list with the characteristics of the userid passwords will be displayed. The format of the list is described on page .
There are no Selection Parameters for the LPPSW User Option.
PROC[ESSOR] The names of the FEPs from which generated terminals are allowed Dialog access to the userid will be displayed.
Selection parameter: srch
Simple or complex search string for the FEP. For a description of the syntax for srch, see page .
PSW-CHECK The access methods for which the correct password must be given in order to logon will be displayed.
The characters DBR indicate, for example, that a password must be specified when logging on in Dialog, Batch or Remote Batch mode.
D-- indicates that a password need only be specified when logging on in Dialog mode.
Selection parameter: dbr
d D|-|* Password will be checked / not checked / irrelevant in Dialog mode
b B|-|*|$ Password will be checked / not checked / irrelevant in Batch mode / checked according to Guard conditions
r R|-|* Password will be checked / not checked / irrelevant in Rbatch mode
G[UARD]= Y|N|srch
Y Password checking for batch access controlled by GUARD
N Password checking for batch access is not controlled by GUARD
srch Simple or complex search string for the GUARD name controlling the password checking for batch access. For a full description of the syntax of srch see page .
PSW-EXDATE The date on which the currently-defined password will expire (as long as it is not amended in the interim by the user) will be displayed.
NONE indicates that no Expiry date has been defined for the Logon password.
Selection parameter: Y | N
Y Select all userids for which a password Expiry date has been defined.
N Select all userids for which no password Expiry date exists.
>x | <x | =x: number of days until the password expires.
or >dd. [mm. [yy] ] | <dd. [mm. [yy] ] | =dd. [mm. [yy] ]: Expiry date of the password after / before / exactly on the specified day.
PSW-LIFETIME The time period during which a valid logon password must be renewed by the user will be displayed.
UNLIMITED indicates that the Logon password does not have any defined lifetime.
Selection parameter: Y | N
Y Select all userids for which a password lifetime has been defined.
N Select all userids which have an unlimited password lifetime.
>x | <x | =x
Number of days within which the user must change the password.
PSW-MAN[AGE] The authorisation to change a Logon password will be displayed.
BY-USER indicates that the user may create, modify or delete the Logon password.
BY-ADMINISTRATOR indicates that only the system administrator may modify or delete the password.
USER-CHANGE-ONLY indicates that the user may only create and modify the password, but may not delete it.
Selection parameter: BY-U | BY-A | USER
BY-U represents the characteristic BY-USER.
BY-A represents the characteristic BY-ADMINISTRATOR.
USER represents the characteristic USER-CHANGE-ONLY.
PSW-MEM[ORY] The password memory list will be displayed for the relevant userid, if one has been defined. The display will include values for the various attributes, such as maximum number of password changes, changes during a particular time period, etc.
Selection parameter:
Y Password memory active
N Password memory inactive
PER[IOD]= >x | <x | =x
Period for the maximum number of password changes in days.
BLOCK[ING]= >x | <x | =x
Number of days for which a password will remain stored in the password memory list.
CHA[NGES]= >x | <x | =x
Maximum number of password changes allowed within the time specified by PERIOD.
#CHA= >x | <x | =x
Number of password changes performed already.
#BLO= >x | <x | =x
Number of prohibited passwords stored in the list.
PSW-MINL Indicates the minimum number of characters that the user needs when choosing a Logon password.
NONE indicates that there are no restrictions placed on the length of the Logon password.
Selection parameter: Y | N
Y Select all userids for which a minimum password length has been defined.
N Select all userids for which no minimum password length has been defined.
>x | <x | =x
The password must have a minimum length of more than / less than / or exactly x characters.
PSW-MINC Indicates the minimum complexity with which the user must create a new Logon password.
NONE indicates that the Logon password does not need to meet any complexity criteria.
Selection parameter: Y | N
Y Select all userids whose password must meet some level of complexity.
N Select all userids whose passwords need have no specified level of complexity.
>x | <x | =x
The password must have a complexity level of greater than / less than / exactly x .
1 No restriction on the complexity.
2 Up to 2 consecutive characters may be the same.
3 The password must contain at least one letter and one number.
4 The password must contain at least one letter, one number and one special character.
TERMINAL | STATION The names of the terminals from which Dialog access to the userid is permitted will be displayed.
Selection parameter: Y | N | srch
Y Select all userids for which terminals allowed to Logon have been defined.
N Select all userids for which no restriction exists in regard to terminal access.
srch
Simple or complex search string for the names of the terminals. For a description of the syntax of srch, see page .
TSET The names of the defined Terminal Sets for which dialog access to the userid is permitted will be displayed. Terminal sets for a particular Join entry can be added from this list. For a description of the format of the list, see page .
Selection parameter:
N Userids for which no Terminal Sets exist.
Y Userids for which at least one Terminal Set is defined.
0 Userids with an empty Terminal Set list
srch Simple or complex search string for the name of the required dialog access Terminal Set. For a full description of the search syntax, see page .
SCOPE= S|G|U
Validity/Class of the Terminal Set name
S (*System), G (*Group), U (*User)
L= +|-
Type of the Terminal Set list
+ Positive list, - Negative list (Except)
Up to BS2000 V10.0 it was only possible to control access to $CONSOLE by defining authorised user processes in the system generation (UCC statements and links to userids). The authorisation of the individual consoles was thus fixed at the time of the system generation.
As from BS2000 V11/OSD V1 it has become possible to use dynamic authorisation when connecting to $CONSOLE. After establishing a connection to the $CONSOLE application as a logical console, the authorisation to execute a variety of commands and Routing Codes can be requested with a REQ-OP-ROLE command. Connecting to $CONSOLE under CFS is achieved using a new format of the connection message.
In CFS, the following should be entered after opening the connection with OCn$CONSOLE:
$CONSOLE|@CONSOLE , user-id [, password] [, protv] [, DISCON=Y|N]
The protv parameter can be used to specify a protocol version for the console application which determines the additional exchange of data between the connection partners (see also the User macros NBBME, NBMAP). The possible values are: V00 | V01 | V02 .
$CONSOLE results in the connection being effected as a terminal, while @CONSOLE appears as a program. Both options are identical. A system difference is that the OPERATOR-ACCESS parameter (see below for further information) only allows console access for a userid for terminals ($CONSOLE) or programs (@CONSOLE).
OPERATOR-PSW-CHECK (see below) can be used to determine, separately for terminals and programs, whether or not the userid password will be checked when connecting.
OPERATOR-CHIPCARD (see below) allows one or more Chipcard IDs to be requested when connecting to the console as a terminal ($CONSOLE). These Chipcard IDs are only relevant when connecting to $CONSOLE. The other Chipcard IDs defined for the userid in the Join entry are only valid in a $DIALOG connection.
After a successful connection to the console has been established, the user must issue a /REQ-OP-ROLE xxxxx console command to allocate Routing Codes through which access will be permitted. The OPERATOR-ROLE determines which commands are permitted during this console session. To create an Operator Role xxxxx, the following commands must be issued from the SYSPRIV userid:
/CREATE-OP-ROLE xxxxx , ROUTING-CODES=( .... )
This command determines the Routing Codes relevant to the Operator Role, and hence the permitted console command set.
/MODIFY-OP-ATTRIBUTES USER-ID=user-id , ADD-OP-ROLES=xxxxx
This command links the Operator Role to a specific userid. This allows a userid to request this Operator Role via a REQ-OP-ROLE command.
OP-LP A list containing the most important Logon Protection characteristics for console access with dynamic authorisation (see above) will be displayed. The format of the list is described on page .
There are no Selection parameters for the User OP-LP Option.
OP-ACCESS The access rights to $CONSOLE will be displayed.
TERM indicates that the user may request a connection to the Console application as a terminal. This means that $CONSOLE may be entered in the Connection Message (see above).
PROG indicates that the user may request a connection to the Console application as a program. This means that @CONSOLE may be entered in the Connection Message (see above).
Selection parameter:
TP Connection as Terminal and Program is possible
T- Connection is possible as Terminal, but not as Program
T* Connection is possible as Terminal, connection as Program is not specified
-P Connection is not possible as Terminal, but is as Program
*P Connection is not specified as Terminal, connection is possible as Program
The Console application access methods which will be checked for a correct password will be displayed
TERM indicates that the userid password must be specified when opening a console connection as a terminal ($CONSOLE,user-id,passw). '----' in the TERM column indicates that the password will not be checked for this type of connection.
PROG indicates that the userid password must be specified when opening a console connection in program mode (@CONSOLE,user-id,passw). '----' in the PROG column indicates that the password will not be checked for this type of connection.
Selection parameter:
TP Password check when connecting as Terminal and Program
T- Password check when connecting as Terminal, but not as Programm
T* Password check when connecting as Terminal. Password checking is irrelevant when connecting as Program
-P Password check when connecting as Program, but not as Terminal
*P Password check when connecting as Program, password check when connecting as Terminal is irrelevant
An indication will be made whether or not the user must be validated with a Chipcard, in addition to userid and password, when connecting to the Console application as a Terminal.
NONE indicates that no Chipcard is required for console acces for this userid.
If a number n appears, this indicates that n Chipcard-IDs are defined for console access, any one of which can be used to validate the user for console access.
Selection parameter: Y | N | srch
Y Select all userids for which Chipcard protection has been defined for console access as Terminal
srch
Simple or complex search string for the Chipcard IDs. For a description of the syntax for such, see page .
Note:
An NPOC Action Code entered alongside an Operator Logon Protection List entry will display all the defined Chipcard IDs for this entry. New IDs can also be defined. For further information, see page .
POSIX (Portable Open System Interface for UNIX) provides a range of UNIX-based standards, which guarantee the compatibility and interoperability of applications in a heterogenous network.
The POSIX Standard was defined in 1989 by the Institute of Electical and Electronics Engineers (IEEE), extended by the X/OPEN consortium and ratified as an international standard (XPG4) in 1990.
The BS2000/OSD Operating System supports the XPG4 Standards (Program interfaces, Commands) as from V2.0.
The POSIX userids are administered from BS2000, whereby each BS2000 user is an equivalent POSIX user. New users are created with an /ADD-USER command. The POSIX user attributes are administered by means of the /MODIFY-POSIX-USER-ATTRIBUTES command.
The User Options described below result in POSIX User Attributes being displayed. The format of the list is described on pages to .
POS[IX] A list containing all POSIX user attributes (User number, Group number, HOME directory, Program name, Comment) will be displayed. The format of the list is described on page .
The POSIX User Option does not have any Selection parameters.
The User number of the POSIX userid will be displayed.
Selection parameter:
>x | <x | =x
The User number can have a numeric value between 0 and 60002.
The Group number of the POSIX userid will be displayed.
Selection parameter:
>x | <x | =x
The Group number can have a numeric value between 0 and 60002.
The name of the HOME directory of the POSIX userid will be displayed. The format of the list is described on page .
Selection parameter: srch
Simple or complex search string for the directory name. For a description of the syntax for srch, see page . By default, the specified strings will be interpreted as Any-Strings (A'...'). This means that the search will return a positive result irrespective of whether the characters appear in the HOME directory name in upper- or lowercase.
The name of the program to be started following a POSIX login will be displayed. *SHELL means that the Korn shell will be invoked. The format of the list is described on page .
Selection parameter: srch
Simple or complex search string for the program name. For a description of the syntax for srch, see page . By default, the specified strings will be interpreted as Any-Strings (A'...'). This means that the search will return a positive result irrespective of whether the characters appear in the program name in upper- or lowercase.
The contents of the comment field in the POSIX userid will be displayed. The format of the list is described on page .
Selection parameter: srch
Simple or complex search string for the program name. For a description of the syntax for srch, see page . By default, the specified strings will be interpreted as Any-Strings (A'...'). This means that the search will return a positive result irrespective of whether the characters appear in the comment field in upper- or lowercase.
The default account number for rlogin access, the rlogin access authorisation, and password checking information will be displayed in the list instead of the User number, Group number and Comment. The format of the list is described on page .
Selection parameter: Y | N [, PSW=Y|N] [, ACCNB=[srch|*NONE|-*NONE] ]
Y Select all POSIX userids for which access via rlogin is permitted.
N Select all POSIX userids for which access via rlogin is not permitted.
PSW=Y
Select all POSIX userids for which the password will be checked when accessing via rlogin.
PSW=N
Select all POSIX userids for which the password will not be checked when accessing via rlogin.
ACCNB=srch
Simple or complex search string for the name of the rlogin default account number. For a description of the syntax for srch, see page .
ACCNB=*NONE
The parameter *NONE will select all those POSIX userids for which no default Account number has been defined, and hence for which no access via rlogin is possible.
ACCNB=-*NONE
The parameter -*NONE will select all those POSIX userids for which a default Account number has been defined, and hence for which access via rlogin can be achieved.
The User Options described below are only relevant for those Join entries relating to SM pubsets as from OSD V3.0 . Therefore, even without specifying additional selection criteria, only SM pubsets will be displayed in the Join list.
The format of the list is described on pages to .
MANAGE-CL This User Option indicates whether a default Management Class has been defined for the SM pubset, and if so, which one.
Management Classes can be used to control HSMS file backup, archiving and long-term storage functions. For example, a file in Management Class xyz should only be migrated to level S2 after 30 days.
Management Classes can be created in HSMS by means of the CREATE-MANAGEMENT-CLASS command.
Selection parameter: srch
Simple or complex search string for the Management Class. For a full description of the syntax for srch see page .
Example:
MANAGE-CL=-*NONE
All Join entries for which a default Management Class has been specified.
STORAGE-CL This User Option indicates whether a default Storage Class has been defined for the SM pubset, and if so, which one.
Storage Classes can be used to determine the storage location for newly-created files. For example, a Management Class can be assigned a list of Volume Sets. New files belonging to this Management Class can automatically be stored on one of these Volume Sets.
Storage Classes can be created by means of a CREATE-STORAGE-CLASS command.
Selection parameter: srch
Simple or complex search string for the Management Class. For a full description of the syntax for srch see page .
Example:
STORAGE-CL=*NONE
All Join entries for which no default Storage Class has been defined.
SPACE-SM A Space list for SM pubsets will be displayed representing the number of PAM pages used by this userid for permanent, temporary and Work files.
The format of the list is described on page .
The SPACE-SM User Option can be used as from OSD V3.0 . Only those Join entries on SM (System Managed) pubsets will be displayed.
Selection parameter:
[>x | <x | =x] [, PERM >x | <x | =x] [, TEMP >x | <x | =x] [, WORK >x | <x | =x]
>x | <x | =x Selection according to the total PAM pages used (TOTAL-USED).
PERM >x | <x | =x Selection according to the PAM pages used for permanent files (PERM-USED). Permanent files are those which have not been designated Work or Tempfile.
TEMP >x | <x | =x Selection according to the PAM pages used for temporary files (TEMP-USED).
WORK >x | <x | =x Selection according to the PAM pages used for Work files (WORK-USED).
The individual selection criteria can be specified in any combination.
SPACE-HA The Space list for files in the High Available area on SM pubsets will be displayed: number of PAM pages used on the pubset by this userid in the High Available area, maximum available, and number still available.
The format of the list is described on page .
The SPACE-HA User Option is available from OSD V3.0 . Only those Join entries on SM (System Managed) pubsets will be displayed.
Selection parameter:
[>x | <x | =x] [, LIM >x | <x | =x | =*MAX] [, DIFF >x | <x | =x | =*MAX]
>x | <x | =x Selection according to the total number of PAM pages used in the High Available area on the pubset (USED-HIGH-AVAIL).
LIM >x | <x | =x | =*MAX
Selection according to the maximum available number of PAM pages which may be created in the High Available area on the pubset (LIM-HIGH-AVAIL).
*MAX indicates the maximum permissable value.
DIFF >x | <x | =x | =*MAX
Selection according to the difference between the maximum permissable number of PAM pages and the number used in the High Available area of the pubset (DIFF-HIGH-AVAIL). *MAX indicates the maximum permissable value.
The individual selection criteria can be specified in any combination.
SPACE-HP The Space list for files in the High Performance area on SM pubsets will be displayed: total number of PAM pages used by files in the High Performance area, number of pages for permanent, temporary, Work files.
The format of the list is described on page .
The SPACE-HP User Option is available from OSD V3.0 . Only those Join entries on SM (System Managed) pubsets will be displayed.
Selection parameter:
[>x | <x | =x] [, PERM >x | <x | =x] [, TEMP >x | <x | =x] [, WORK >x | <x | =x]
>x | <x | =x Selection according to the total number of PAM pages used in the High Performance area of the pubset (TOTAL-HP-U).
PERM >x | <x | =x Selection according to the number of PAM pages used by permanent files in the High Performance area of the pubset (PERM-HP-U). Permanent files are those not cataloged as a Work or Tempfile.
TEMP >x | <x | =x Selection according to the number of PAM pages used by temporary files in the High Performance area of the pubset (TEMP-HP-U).
WORK >x | <x | =x Selection according to the number of PAM pages used by Work files in the High Performance area of the pubset (WORK-HP-U).
The individual selection criteria can be specified in any combination.
SPACE-VHP The Space list for files in the Very High Performance area on SM pubsets will be displayed: total number of PAM pages used by files in the Very High Performance area, number of pages for permanent, temporary, Work files.
The format of the list is described on page .
The SPACE-VHP User Option is available from OSD V3.0 . Only those Join entries on SM (System Managed) pubsets will be displayed.
Selection parameter:
[>x | <x | =x] [, PERM >x | <x | =x] [, TEMP >x | <x | =x] [, WORK >x | <x | =x]
>x | <x | =x Selection according to the total number of PAM pages used in the Very High Performance area of the pubset (TOTAL-VHP-U).
PERM >x | <x | =x Selection according to the number of PAM pages used by permanent files in the Very High Performance area of the pubset (PERM-VHP-U). Permanent files are those not cataloged as a Work or Tempfile.
TEMP >x | <x | =x Selection according to the number of PAM pages used by temporary files in the Very High Performance area of the pubset (TEMP-VHP-U).
WORK >x | <x | =x Selection according to the number of PAM pages used by Work files in the Very High Performance area of the pubset (WORK-VHP-U).
The individual selection criteria can be specified in any combination.
SPACE-SL The Space list for files under different HSMS Storage levels on the SM pubsets will be displayed: number of PAM pages used in S0, S1, S2, as well as the maximum number available under S0 and the difference between S0-Limit and S0-Used.
The format of the list is described on page .
The SPACE-SL User Option is available from OSD V3.0 . Only those Join entries on SM (System Managed) pubsets will be displayed.
Selection parameter:
[>x | <x | =x] [, S0 >x | <x | =x] [, S1 >x | <x | =x] [, S2 >x | <x | =x] [, LIM >x | <x | =x] [, DIFF >x | <x | =x]
>x | <x | =x Selection according to the number of PAM pages used in the S0 level (S0-USED).
S1 >x | <x | =x Selection according to the number of PAM pages used in the S1 level (S1-USED).
S2 >x | <x | =x Selection according to the number of PAM pages used in the S2 level (S2-USED).
LIM >x | <x | =x Selection according to the maximum permissable number of PAM pages in the S0 level which may be used by files on this pubset and under this userid (S0-LIMIT).
DIFF >x | <x | =x Selection according to the difference between the maximum limit and space used in the S0 level (S0-DIFF).
The individual selection criteria can be specified in any combination.
Selection mask : DOCUMENTATION
This field is not used to select entries. The name of a file can be specified here, into which the Join list displayed on the screen will be written in a print-ready form.
file The Join list currently on the screen should be written in a print-ready BS2000 file of the specified name. The file thus created can be printed with SPACE=E.
file, E An existing Documentation file will be opened in EXTEND mode.
file, INF Information captured in a Join Information Catalog by means of the IM Action Code (see page ) will also be written to the file. Only the first 52 non-blank characters from the list will be copied. This way, each print line will be filled up to line 132 with the documentation information from the individual Join entries.
file, INF, ALL [, SKIP]
As above, except that the complete description for each Join entry in the list will be copied. Appending SKIP will cause empty lines (80 blanks) in the documentation file to be suppressed.