Previous Topic: SET SITE CommandsNext Topic: Site Control of Wide Panel Support


Session Control Facility Options

You can set the Session Control Facility options using a fill-in. The CA Ideal Administrator accesses this fill-in with the following command:

SET COMMAND SITE [OPTIONS]

The following illustration reflects how the fill-in appears when CA Ideal is first installed. Changes to these options take effect immediately.

=> ------------------------------------------------------------------------------- IDEAL: SCF option block SCF#OPTIONS FILL-IN Set SCF “site” options -------------------------- Command “comment” character: : Command “delimiter” character: ; Command “repeat” character: - Command “reshow” character: Number of command lines: 3 (0-5) Decimal symbol: . (. ,) Currency symbol: $ Date format: A (A, E, I) Region separator: - (N=none, G=grid, other=itself) Asynchronous messages: U (U=User, N=None) Command reshow? N (Y/N) UPPER CASE PANELS AND MESSAGES? N (Y/N) Translate to upper case in batch? N (Y/N) Maximum number of regions : 4 (1-4) Maximum number of PF keys : 48 (0-48) Maximum number of PA keys : 4 (0-4) Size of the working buffer: 4000 (4000 - 64000) Log file name : ADRL Trace file name : ADRT Check duplicate user: N (Y/N)

The following list provides an explanation of the fields in the previous screen shown:

Command “comment” character

Establishes the default command comment character. This character marks the beginning of a comment in the command area. You can specify any special character (except underscore). (You can use command comments to defer execution of commands online until the comment character is removed or for commands in batch.)

Note: In a CA Ideal member, the colon (:) is the only comment character recognized, regardless of the SCF option setting.

Command “delimiter” character

Establishes the default command delimiter that separates multiple commands entered on a single command line. Specify any non-national special character (except underscore). Each user can specify a different command delimiter character. The command delimiter is valid only for screen input online.

Command “repeat” character

Establishes the default command repeat character. You can enter this character to cause re-execute the most recently executed command. Specify any special character (except underscore).

Command “reshow” character

Establishes the default command reshow character. This character causes all subsequent commands to remain in the command area after execution. Specify any special character (except underscore).

Number of command lines

Establishes the default number of command lines reserved in the command region.

Limit: 0 to 5

Decimal symbol

Establishes the default decimal symbol. The digit separator character defaults to the opposite of this decimal symbol. Valid values are as follows:

Currency symbol

Establishes the default currency symbol. You can specify any character. The installation default is a hex '5B', which displays as a dollar sign on United States English terminals.

Date format

Establishes the default date format. Valid values are as follows:

Region separator

Establishes the default command region separator character. A separator line consists of this character, repeated across the screen, to distinguish between the command area and the execution regions. Valid values are:

Asynchronous messages

Establishes whether asynchronous messages, such as print and compile completion messages, display during the session by default. Valid values are:

You can set this option to NONE to prevent users from receiving someone else's messages from a previous session on the same terminal.

Command reshow

Establishes the default action for commands. Yes retains all commands in the command region after execution. No erases all successfully executed commands from the command area after execution.

UPPER CASE PANELS AND MESSAGES

Establishes the default system panels as uppercase panels and displays all messages in uppercase as the default.

Translate to upper case in batch

Indicates whether text submitted for printing in batch is converted to uppercase. Enter Y (yes) for translation to uppercase or N (no) for no translation.

Maximum number of regions

Establishes the maximum number of regions a user can specify.

Limit: 1 to 4

The command region (region number 0) and product region (region number 1) count as 2, therefore specify 3 or 4 to allow SPLIT to start a second or third session.

Maximum number of PF keys

Establishes a limit on the number of PF keys supported.

Limit: 0 to 48

Maximum number of PA keys

Establishes a limit on the number of PA keys supported.

Limit: 0 to 4

Size of the working buffer

Establishes the size of the buffer CA Ideal editors use for global editing. A larger value speeds up editing at the expense of main memory.

Limit: 4000 to 64000

Log file name

Establishes the CICS TDQueue name of the Log File. Specify one to four characters. The first character must be an alphabetic or national character. The rest can be alphabetic, national, or digits. This name must be the same as the name specified for the IPC DCT entries in CA Ideal's IDSYSFT and IDLCICS and in the procedure that executes IDBATCH.

Trace file name

The CICS TDQueue name of the Trace File. Specify one to four characters. The first must be an alphabetic or national character. The rest can be alphabetic, national, or digits. This name must be the same as the name specified for the CA IPC DCT entries in CA Ideal's IDSYSFT, IDLCICS, and in the procedure that executes IDBATCH.

Check duplicate user

Establishes whether duplicate signons are allowed. Specify Y to prevent users from signing on when they are already signed on with the same host user definition somewhere else. Specify N if your external security system ensures unique signons or if you want to allow duplicate signons.

Note: To check for duplicate user IDs at signon when SC00PTS SECRTY=N, CICS sites must provide a CICS op-ID in the TCTTEOI.

Site Options for Output

To change any of the PSS site options, sign in to CA Ideal and issue one of the following commands:

SET OUTPUT SITE OPTIONS

Or

SET OUT SITE

This command retrieves the current set of PSS site option values and displays them in the following panel:

=> ----------------------------------------------------------------------------- IDEAL: SET OUT OPT (PSS) PSS#OPTIONS FILL-IN Set PSS "site" options ------------------------ Spool name: ADROUT Maximum number of lines: 64000 (1-64K) Default retention period: 02 (1-99) Default number of copies: 01 (1-99) Default print status: RELEASE (Release/Hold/Keep) Default output width: 120 (1-240) Default network printer width: 132 (0-240) Post successful msg: Y (y/n) Name of the batch JCL proc: PSSUTIL Default destination Type: LIBRARY (LIBrary/NETwork/SYStem/MAIl) Name ___________________________________________________ Date format A (A, E or I) Directory name: $PSSDIR$ Destination table name: $PSSDST$ System name: PSS Prefix name: PSS# Suppress non-display characters N (y/n) Maximum retention period: 03 (1-99) Maximum number of output members: 0500 (10-9999) Percent full occupancy warning: 99 (1-99) Multiple CPU environment: N (y/n)

To display this panel, you must have Print Administrator authorization. If you must change a PSS site option, and you do not have proper authorization, contact your site coordinator.

To modify a PSS site option, overtype a field entry and press Enter. Each change is stored in the PSS and remains in effect until it is modified again.

If you change the value of any of these options, the change affects all of the people using CA Ideal print files. Changes only take effect in sessions that begin after you specify new site options. A person who is using CA Ideal as you specify site options must sign out and then sign in to have the new options take effect.

A subset of the options that are contained on this fill-in is available to CA Ideal users, so that you can override some site options for the current session. The fill-in containing these session options is accessed with the SET OUTPUT SESSION OPTIONS command. For more information, see the Working in the Environment Guide.

Spool name

Specify a valid file name. Specifies the ddname of the output library. Before you modify this value, see How to Change Default File Names in the IPC Implementation Guide for z/OS.

Maximum number of lines

Specifies the maximum number of lines a report can contain when an output member is generated on-line. The valid values are numbers from 1 through 64000. However, the session option value cannot be greater than the site option value. There is no limit to the length of an output member that is generated in batch.

The following syntax shows the command to set this option:

 ►►─ SET ─┬─ OUTPUT ─┬── MAXLINES ─ nnnnn ─────────────►◄
          └─ OUT ────┘ 
Default retention period

Specifies the number of days an output is retained in the output library before it is automatically removed. The valid values are numbers from 1 through 99; however, the session option value cannot be greater than the site option value.

The following syntax shows the command to set this option:

 ►►─ SET ─┬─ OUTPUT ─┬─┬─ RETENTION ─┬─ nn ──────────────►◄
          └─ OUT ────┘ └─ RET ───────┘ 
Default number of copies

Specifies the number of copies to print if COPIES=nn is not specified in the DESTINATION clause of a PRINT command. The valid values are numbers from 1 through 99.

The following syntax shows the command to set this option:

 ►►─ SET ─┬─ OUTPUT ─┬─ COPIES ─ nn ──────────────►◄
           └─ OUT ────┘ 
Default print status

Specifies the default status that is assigned to all generated outputs. Specify one of the following statuses:

The following syntax shows the command to set this option:

     ►►─ SET ─┬─ OUTPUT ─┬─┬─ DISPOSITION ─┬─┬─ HOLD ─────┬───────────────►◄
              └─ OUT ────┘ └─ DISP ────────┘ ├─ HOL ──────┤
                                             ├─ RELEASE ──┤
                                             ├─ REL ──────┤
                                             ├─ KEEP ─────┤
                                             └─ KEE ──────┘
Default output width

Specifies the default width for all generated outputs. The valid values are numbers from 1 through 240.

The following syntax shows the command to set this option:

 ►►─ SET ─┬─ OUTPUT ─┬─ WIDTH ─ nn ──────────────►◄
          └─ OUT ────┘ 

Note: CA Ideal always overrides the default width internally with the actual report width.

Default network printer width

Specifies the default network printer width for all outputs. The valid values are numbers from 0 through 240.

When an output is routed to a network printer, the printer width is determined in the following manner:

Post successful msg

Specifies if the user receives the informational message ICPSMSGS31I - Command successfully processed OUTPUT NUMBER=nnn when a print request is processed.

Y - Post the message.

N - Most likely used in an application environment when the requester does not need to know the output number.

Name of the batch JCL proc

Specifies the procedure that contains the JCL for processing batch PSS system prints.

The following syntax shows the command to set this option:

 ►►─ SET ─┬─ OUTPUT ─┬─┬─ PROCEDURE ─┬─ procname ───────►◄
          └─ OUT ────┘ └─ PROC ──────┘

Note: This procedure must be defined with COPIES=nn and DEST=dest-id statements. These statements are included in the EXEC SCPSUTIL statement that is generated internally when PSS processes system print requests.

Default destination type

Specifies the printout destination type as one of the following. You enter the name for the system or network name, or CA eMail+ recipient.

SYS|SYSTEM - System printer

NET|NETWORK - Network printer

LIB|LIBRARY - Output library

MAI - CA eMail+

The following syntax shows the command to set this option:

     ►►─ SET ─┬─ OUTPUT ─┬─┬─ DESTINATION ─┬─┬─ SYSTEM ─ name ─────┬───────────────►◄
              └─ OUT ────┘ └─ DEST ────────┘ ├─ SYS ─ name ────────┤
                                             ├─ NETWORK ─ name ────┤
                                             ├─ NET ─ name ────────┤
                                             ├─ LIBRARY ───────────┤
                                             ├─ LIB ───────────────┤
                                             └─ MAI ─ /recipient/ ─┘

Note: Notice that you must use slashes as delimiters in the MAI keyword.

Default destination name

Specifies the name of the SYSTEM or NETWORK printer or CA eMail+ recipient that is used as the default print destination. Specify a valid system, network name, or CA eMail+ recipient.

The following syntax shows the command to set this option:

     ►►─ SET ─┬─ OUTPUT ─┬─┬─ DESTINATION ─┬─┬─ SYSTEM ─ name ─────┬───────────────►◄
              └─ OUT ────┘ └─ DEST ────────┘ ├─ SYS ─ name ────────┤
                                             ├─ NETWORK ─ name ────┤
                                             ├─ NET ─ name ────────┤
                                             ├─ LIBRARY ───────────┤
                                             ├─ LIB ───────────────┤
                                             └─ MAI ─ /recipient/ ─┘

Note: Notice that you must use slashes as delimiters in the MAI keyword.

Date format

Specifies the default date format PSS uses. This value is used during RECOVERY processing. At that time, the Julian date is calculated to determine which outputs exist beyond their retention period. The valid values are:

A - American, date format: mmddyy

E - European, date format: ddmmyy

I - International, date format: yymmdd

Where:

mm Is the month

dd Is the day of the month

yy is the year

Directory name

Specifies the name of the directory that contains a list of all items in the output library. When this entry is changed to an existing name of a directory member name, this member closes and a directory of the same name is reopened. When a directory of the same name is reopened, it is not reinitialized. When this entry is changed to a new directory name, a new spool directory of this name is created and initialized for further processing.

Destination table name

Specifies the name of the table that contains all valid destinations that are defined in the print environment. If you change this name, the existing destination table is released from global storage and then reinitialized on the next destination table access. Also, you lose all output in the destination file.

System name

Specifies a three-character prefix that builds the internal name of each output in the output library, the directory name, and the destination table name. If you change this name, the PSS entities are internally named and referenced differently. Therefore, changing this value has the same effect as changing the destination table name or directory name. After you change this value, reinitialize ADROUT.

Prefix name

Specifies the four-character prefix for all print members. After you change this value, reinitialize ADROUT. This value should be unique for each ADROUT to avoid enqueuing conflicts between members.

Suppress non-display characters

Specifies whether to suppress non-display characters. Set this value to N if unprintable content is needed in control streams that are sent as part of the data, such as escape sequences. With this value set to Y, the data content sent to the printer has any undisplayable characters translated out. For most current printers, the control data is displayable characters. For information on non-display characters, see the IPC Implementation Guide for z/OS, How to Modify the PMS Conversion Tables (PMSTRUC, PMSTRND, and PMSTRNDK).

Maximum retention period

Specifies the maximum number of days that an output can be retained. Each user can set a different retention period for each output that is less than or equal to the default. However, this value must be greater than or equal to the value specified as the default retention period. A valid value is a number from 1 through 99.

Maximum number of output members

Specifies the maximum number of outputs that can exist on the output library simultaneously. A valid value is a number from 10 through 9999. This value is used when a directory is initialized to specify the maximum number of entries to create in the PSS directory. You can change this value only if the named directory does not already exist. Changing this value creates a directory in the spool with the number of entries specified.

Percent full occupancy warning

Specifies when PSS issues a library full message. A valid value is a number from 1 through 99. This value determines the point that PSS prevents more outputs from being created, so that it has enough space for outputs in progress to be completed.

Multiple CPU environment

Specifies the processor environment. If you have multiple processors with shared DASD, specify Y (yes). PSS generates a /*JOBPARM SYSAFF=* for batch jobs that are submitted to process PRINT commands directed to a system printer. Otherwise, specify N (no).