TSO Full-Screen Logon Retention Records

When the TSO full-screen retention facility is active, acf assumes that the logon parameters desired are those specified in the user's logonid record. The acf TSO preprompt exit (IKJEFLD) maintains the CONTROL(TSO) records internally. These records retain the logon parameters specified during the most recent TSO logon.  When those parameters differ from the logonid record, a retention record is created in the Infostorage database.
acf2src
When the TSO full-screen retention facility is active,
ACF2
assumes that the logon parameters desired are those specified in the user's logonid record. The
ACF2
TSO preprompt exit (IKJEFLD) maintains the CONTROL(TSO) records internally. These records retain the logon parameters specified during the most recent TSO logon.  When those parameters differ from the logonid record, a retention record is created in the Infostorage database.
Use of the logon parameter retention facility requires that:
  • Full-screen TSO logon is selected in the individual logonid record. The TSOFSCRN field selects the full-screen logon.
  • The FSRETAIN field is specified in the global system options (GSO) TSO record.
By default, the logon parameter retention facility is inactive unless you explicitly activate it, as described previously. Once activated, management of the supporting CONTROL(TSO) records is automatic and requires no administrative attention. However, a security administrator or INFOLIST privileged user can list the retention records.
Since the management of retention records is performed internally, no external facility is provided to update the fields contained in these records. ACF command support for CONTROL(TSO) records is provided primarily to review the use of the retention facility. In fact, when using the SET subcommand, SYSID does not need to be stated. Additionally, if you discontinue the use of the retention facility for any reason, the ACF command can be used to delete any or all of the unused retention records.
When a logon retention record is created, the user's logonid becomes the name of that user's retention record ID. The fields contained in the user's record are described in the following. When listed, only those parameters that differ from the defaults found in the logonid record are displayed.
  • ACCOUNT
    Identifies the TSO logon account string. This field corresponds to the TSOACCT field of the logonid record.
  • ATTR1
    Defines the status of the retention record. These flags are for internal use only and have no counterpart in the logonid record.
  • ATTR2
    Defines the status of the retention record. These flags are for internal use only and have no counterpart in the logonid record.
  • ATTR3
    Defines the status of the retention record. These flags are for internal use only and have no counterpart in the logonid record.
  • COMMAND
    Contains a TSO command issued immediately after logon is completed when your systems programmer activates the command string feature. This field has no counterpart in the logonid record.
  • MSGCLASS
    Identifies the SYSOUT class to which the TSO session is assigned. This field has no counterpart in the logonid record.
  • PERFORM
    Identifies the MVS performance group the TSO session runs under. This field corresponds to the TSOPERF field of the logonid record.
  • PROC
    Identifies the TSO JCL procedure name. This field corresponds to the TSOPROC field of the logonid record.
  • REGION
    Identifies the MVS region size in kilobytes. This field corresponds to the TSORGN field of the logonid record.
  • TIME
    Identifies the CPU time limit associated with the TSO session. This field corresponds to the TSOTIME field of the logonid record.
  • UNIT
    Identifies the default MVS unit name selected during data set allocations. This field corresponds to the TSOUNIT field of the logonid record.