Time-Sharing Options and Defaults (TSO)

The TSO record specifies global usage and system parameters that define and control the TSO logon process and other system parameters.
acf2src
The TSO record specifies global usage and system parameters that define and control the TSO logon process and other system parameters.
CA ACF2 provides a default TSO record that you can modify.
Record ID
Fields
TSO
ACCOUNT(
1
|
string
)
BYPASS(
#
|
character
)
BYPPAUSE|
NOBYPPAUSE
CHAR(BS|NO|
character
)
CMDLIST(
moduleid
)
FSRETAIN|
NOFSRETAIN
IKJEFLD1|
NOIKJEFLD1
LINE(ATTN|CTLX|
character
)
LOGHERE
|NOLOGHERE
LOGONCK|
NOLOGONCK
PERFORM(
0
|
nnn
)
PROC(
IKJACCNT
|
procedure
)
PWPHRASE|
NOPWPHRASE
QLOGON
|NOQLOGON
REGION(
2048
|
nnnn
)
SUBCLSS(
class
)
SUBHOLD(
class
)
SUBMSGC(
class
)
TIME(
0
|
nnn
)
TSOGNAME(name)
TSOSOUT(
A
|
class
)
UNIT(
SYSDA
|
unitname
)
WAITIME(
0
|
nnn
)
Field Descriptions
The TSO record fields are described in the following (an asterisk (*) means active only if UADS is bypassed):
  • *ACCOUNT(
    1
    |
    string
    )
    Specifies the system-wide default TSO account number. The default value is 1. If you set this string to blanks and do not specify ACCOUNT in the logonid record, an account prompt occurs at logon regardless of the UADS setting. This string is put in parentheses when it is moved to the job statement.
  • BYPASS(
    #
    |
    character
    )
    Defines the TSO command list bypass character. The default value is a pound sign (#).
  • BYPPAUSE|
    NOBYPPAUSE
    Bypasses the CA ACF2 message prompt during TSO signon. CA ACF2 uses an intercept in the TSO Logon Preprompt exit, IKJEFLD, which CA ACF2 dynamically implants. The intercept validates a users TSO authority at system entry. The purpose of the BYPPAUSE field is to restrict the display of informational CA ACF2 SVC messages and prompt issued in this intercept. The BYPPAUSE setting indicates any 
    CA ACF2
     SVC informational messages will not be displayable to the user and no pause or message prompt, denoted by three asterisks ‘***’ will be issued. The NOBYPPAUSE setting enables users to read any 
    CA ACF2
     SVC message during logon because the prompt pauses the signon process until the user responds. The default is NOBYPPAUSE.
  • *CHAR(BS|NO|
    character
    )
    Defines the default TSO delete character. When entered at the terminal, this character indicates that the previous character entered should be ignored. This optional field has no default value. BS indicates that the backspace character deletes the last character entered. NO indicates no character-delete character desired.
  • CMDLIST(
    moduleid
    )
    Specifies the default TSO command limiting list. If you specify a module, no users, even privileged logonids, can run without the command list present in a link list library. This field is optional and has no default. It is effective in all modes with the exception of QUIET.
  • FSRETAIN|
    NOFSRETAIN
    Controls the retention of logon values from session to session if TSO full-screen logon is supported. NOFSRETAIN, the default, indicates that the user has to provide applicable values at each logon.
    FSRETAIN specifies that CA ACF2 gets account and procedure values from the previous session, even if you specify PMT-ACCT or PMT-PROC in the logonid record.
  • IKJEFLD1|
    NOIKJEFLD1
    Indicates that CA ACF2 will dynamically link authorized logon pre-prompt, IKJEFLD1 into LPALIB. This lets you use the authorized logon pre-prompt exit. You must perform the CA ACF2 REFRESH command to activate the IKJEFLD1 facility. The default is NOIKJEFLD, which indicates CA ACF2 will not dynamically link the authorized logon pre-prompt exit. Note: Once activated, an IPL is required to deactivate the IKJEFLD1 facility.
  • *LINE(ATTN|CTLX|
    character
    )
    Specifies the system-wide default TSO line-delete character. When entered at the terminal, this character indicates that the current line should be ignored. This optional field has no default value. ATTN indicates that an attention interruption deletes the current line. CTLX indicates that the X and CTRL keys pressed simultaneously delete the current line (for Teletype terminals).
  • LOGHERE
    |NOLOGHERE
    Indicates whether a user signing on to a TSO terminal can pre-empt an existing session for the same logonid and transfer that session to the terminal at which the user is signing on. The default is LOGHERE.
    This functionality is also governed by the setting of the LOGONHERE attribute in the IKJTSOxx member of SYS1.PARMLIB and if LOGONHERE(NO) is specified there, re-connection at logon will not be supported.
    'F ACF2,REFRESH(TSO)
  • LOGONCK|
    NOLOGONCK
    Indicates whether CA ACF2 checks the TSO attribute in the user's logonid record. If you specify LOGONCK and the user does not have the TSO attribute in his logonid, CA ACF2 rejects the logon attempt. The default value is NOLOGONCK.
  • *PERFORM(
    0
    |
    nnn
    )
    Specifies the system-wide default TSO performance group. If you specify zero, no performance group (PERFORM=) parameter is placed on the job statement. The default value is zero.
  • *PROC(
    IKJACCNT
    |
    procedure
    )
    Specifies the default TSO cataloged procedure name. Specify the default value for an individual user with the TSOPROC field of the logonid record.
  • PWPHRASE|NOPWPHRASE
    Indicates whether CA ACF2 will allow TSO logon with a password phrase. You may log on to TSO with your password or your password phrase when the GSO TSO record has the option on.
    If your logonid has the PWPALLOW option on but the GSO PWPHRASE record has NOALLOW, you will not be able to use a password phrase for TSO logon.
    Users will need to have an existing password phrase.
    All password phrases used for TSO logon must be entered in single quotes. The forward slash is still used to separate old and new password phrases. The following are some examples:
    1. ACF82003 ACF2, ENTER LOGON ID - FZLID/'some people like cupcakes     better'/'i for one could care less for them' PROC(TSOPROC2)  2. ACF82003 ACF2, ENTER LOGON ID - FZLID/'i for one could care less     for them'  3. ACF82003 ACF2, ENTER LOGON ID - FZLID     ACF82006 ACF2, ENTER PASSWORD OR PASSWORD PHRASE - 'i for one could     care less for them'  4. ACF82003 ACF2, ENTER LOGON ID - FZLID     ACF82006 ACF2, ENTER PASSWORD OR PASSWORD PHRASE - 'i for one could     care less for them'/'a dense but radiant muffin of his own design'
    The default value is NOPWPHRASE. When NOPWPHRASE is set, users can only log on to TSO using their password.
  • QLOGON
    |NOQLOGON
    Specifies whether a quick logon is permitted. This lets CA ACF2 accept the password specified on the first line instead of forcing a prompt. When QLOGON is in effect, password integrity can be jeopardized. The default value is QLOGON.
  • *REGION(
    2048
    |
    nnnn
    )
    Specifies the default TSO region size. The TSORGN option in the logonid record or a size specification at TSO logon time can override this value. If this field is zero and the user does not specify a region size at logon time or in the logonid record, CA ACF2 assumes that the region has been specified in the TSO logon procedure and no value is passed by CA ACF2 to TSO. If this field is zero, the SHOW TSO command will indicate “NONE”. The default value is 2048.
  • *SUBCLSS(
    class
    )
    Specifies the default TSO job submission class. This field is active only if TSO/E is also installed. This is an optional field and has no default value.
  • *SUBHOLD(
    class
    )
    Specifies the default submit hold class. This field is active only if TSO/E is also installed. This is an optional field and has no default value.
  • *SUBMSGC(
    class
    )
    Specifies the default submit message class. This field is active only if TSO/E is also installed. The default value is null.
  • *TIME(
    0
    |
    nnnn
    )
    Specifies the default time estimate for TSO sessions in minutes. If you specify zero, no TIME parameter is placed on the job statement. The default value is zero. The maximum value is 1439.
  • TSOGNAME(
    name
    )
    Specifies a one- to eight-character value for the application name used at TSO logon for PassTicket validation. If TSOGNAME is not specified, the application name will default to "TSO" followed by the four character SMF SYSID of the system. The default value of TSOGNAME is null.
  • TSOSOUT(
    A
    |
    class
    )
    Specifies the default class for spun TSO SYSOUT. This field is active only if TSO/E is also installed. The default value is A.
  • *UNIT(
    SYSDA
    |
    unit name
    )
    Specifies the default UNITNAME used in TSO allocation requests. The default value is SYSDA.
  • WAITIME(
    0
    |
    nnn
    )
    Specifies whether CA ACF2 should time user responses. If you specify a nonzero value, that is the amount of time permitted between prompts. CA ACF2 aborts the logon if the user exceeds wait time. The value you specify as 
    nnn
     must be less than or equal to 120 seconds. The default value is zero (no check takes place).
Displaying TSO Options
The SHOW TSO and SHOW ACF2 subcommands of the ACF command display the TSO options as specified in the TSO record.