The OP (Options) command displays, sets, or resets run-time operating system options that affect various system operations.

Syntax

<option list>

The available run-time operating system options and their corresponding numbers are:

Explanation

OP

Displays all options and their respective states.

OP +

Displays all options that are set.

OP + <option list>

Sets all options in the option list.

OP −

Displays all options that are reset.

OP − <option list>

Resets all options in the option list.

OP <option list>

Displays the options in the option list and their respective states.

<number>

Identifies the option desired. The number is between 1 and 47; however, some values are not used. The number of each option is listed with the following descriptions.

OPEN (option 1)

If this option is set, the system displays a message whenever a task opens a file.

TERMINATE (option 2)

If this option is set, abnormal task terminations are processed normally.

If the option is reset, abnormal terminations, faults, configuration errors, file open failures, and other various error conditions result in a memory dump. Some of the conditions that cause dumps when the option is reset, such as file open failures, can occur frequently. Because frequent file open failures results in a large number of system memory dumps, the TERMINATE option normally should be set. Reset it only if you need a memory dump to assist in diagnosis of a problem.

If a file open operation fails while the TERMINATE option is reset, a system memory dump is taken with a dump cause of OPEN ERROR #n. The value of n corresponds to the values of the HISTORYREASON task attribute for HISTORYTYPE=4 (DSEDV) and HISTORYCAUSE=8 (SOFTIOERRORCAUSEV). These attribute values are listed in the description of the HISTORYREASON attribute in the Task Attributes Programming Reference Manual. For example, a dump by OPEN ERROR #0000093 indicates that the open failed because the file was not available.

NOCHECK (option 3)

If this option is set, memory dumps under FORGETCHECK conditions are inhibited. These dumps are automatic if the option is reset.

LPBDONLY (option 4)

If this option is set, normal printer output files are assigned to a printer backup disk or tape. (The printer backup disk or tape is determined by the SB and DL BACKUP specifications.) Printer backup disk files can then be printed by the Print System, the SYSTEM/BACKUP utility, or the Work Flow Language (WFL) PRINT statement. The LPBDONLY option does not affect the assignment of printer files that are DIRECT files, files that have the UNITNO file attribute set to a nonzero value, files that have the PRINTDISPOSITION file attribute set to DIRECT, or files that have the BACKUPKIND file attribute set to a specific type of device, such as TAPE.

AUTORM (option 5)

If this option is set, the system automatically removes the old disk file when a duplicate-file condition occurs. If the option is reset, an RM (Remove) or OF (Optional File) command is required when such a condition occurs.

DIAGNOSTICS (option 6)

If this option is set, an RSVP message (for example, RF DEGRADATION) is displayed at the ODT any time the reliability of a hardware unit is degraded by a set amount and other diagnostic messages and dumps occur. If the option is reset, an informational message is displayed. For more information about the reliability of system units, refer to the RF (Reliability Factor) command.

If this option is set, the system reissues the recall request for outstanding station messages, if they are not recalled by the first request. If the second recall request is unsuccessful, the system takes a non-fatal dump.

AUTORECOVERY (option 8)

If this option is set, a halt/load is attempted after all system-fatal memory dumps (except dumps caused by a suspended processor).

If this option is reset, the system reports a deadstop condition after all system-fatal memory dumps. For systems with Console Recovery support, a deadstop condition specifies halt/loading the partition. If the Console Recovery option is set to load the partition, the system is automatically loaded. Otherwise, the system remains halted. Furthermore, the AUTORECOVERY operations do not occur after a halt/load, and the mix limit of all queues is set to a value of 0 so that no jobs are automatically restarted.

DUPSUPERVISOR (option 9)

If a code file titled <file name> is designated as the supervisor program and this option is set, at halt/load time the system executes a code file titled <file name>/FMLYINXnnn. If this option is reset, the system executes the designated supervisor program. The number <nnn> in the file name represents the family index of the current halt/load unit. If you use this option, it is recommended that you locate the supervisor file on each halt/load pack and name the file with the appropriate suffix.

For more information about the supervisor program, refer to the CS (Change Supervisor) command.

DUPINTRINSICS (option 10)

If a file titled <file name> is designated as the intrinsics file and this option is set, at halt/load time the system uses the code file titled <file name>/FMLYINXnnn as the intrinsics file. If the option is reset, the code file <file name> is used as the intrinsics file at halt/load time. The number <nnn> in the file name represents the family index of the current halt/load unit. If you use this option, it is recommended that you locate the intrinsics file on each halt/load pack and name the file with the appropriate suffix.

For more information on the intrinsics file, refer to the SI (System Intrinsics) command.

TRANSWARNINGS (option 11)

If this option is set and a program is given translation warnings, then the translation warnings are displayed and the code file is marked as having been given translation warnings. (Translation warnings are issued when a file is opened and there is a risk of invalid data access and/or data corruption.)

If the option is reset, the translation warning mechanism is inactive. By default, the TRANSWARNINGS option is reset. For more information about translation, refer to the I/O Subsystem Programming Guide.

AUTODC (option 12)

If this option is set, data comm is automatically initiated if it is not running when an MCS performs a station attach DCWRITE operation. For additional information about AUTODC, refer to the ID <unit number> explanation in the ID (Initialize Data Comm) command.

The AUTODC option works as documented provided a station is defined in the SYSTEM/DATACOMINFO file as belonging to an MCS.

NODUMP (option 13)

If this option is set, the system does not try to take memory dumps. However, this option does not prevent the system from taking a memory dump if someone requests the memory dump by using the ??DUMP system command, a SETSTATUS DUMP call, or the MARC system software. Potential nonfatal dumps are denoted by a display at the supervisory console and logged. The source of a fatal dump is listed in a system display at halt/load time. If the option is reset, dumps are taken in the normal fashion.

The NODUMP option does not suppress a fast memory dump, as enabled through configuration of a MEMORYCEILING and the setting of the MDT FASTDUMP option. It will, however, suppress a memory dump if the fast dump region of memory is not available due to a previous dump that has yet to be processed.

For more information about memory dump processing, refer to Memory Dump Processing.

AUTORUNNING (option 15)

When this option is set, certain default actions are taken in response to some of the RSVP conditions that can arise during initialization. For some of these default actions, instead of waiting for you to reply, the RSVP message and the following message are displayed:

'OP AUTORUNNING' IS SET, REPLY <reply> ASSUMED

The reply indicates the default action selected by the system.

AUTORUNNING also controls the way that operator intervention is handled during memory dumps. When the AUTORUNNING option is set, the DUMPDISKMASTER independent runner always creates a dump file on disk. If the DL DPFILES specification is null, the default disk location is the halt/load family.

System initialization takes the following default actions when you set the AUTORUNNING option:

System memory dumps take one of the following default actions when you set the AUTORUNNING option:

For more information about creating and unloading fast memory dump and dumpdisk files, refer to the CM (Change MCP), DN (Dump Name), DF (Empty Dumpdisk File), DL (Disk Location), MDT (Memory Dump Type), and MEMORYCEILING (Set Memory Ceiling) commands. Also, refer to Memory Dump Processing.

For more information about the Dumpanalyzer utility, refer to the System Software Utilities Manual.

CRUNCH (option 16)

If this option is set, code files and backup disk files are automatically crunched when they are closed. Furthermore, when this option is set, you can crunch other files by using the CRUNCH option in the CLOSE statement. If this option is reset, no file can be crunched, even if a crunch is explicitly requested.

BACKUPBYJOBNR (option 17)

If this option is set, print requests are selected for printing by job number. If this option is reset, print requests are selected for printing according to the criteria specified in the PS SELECTION command.

PDTODISK (option 18)

This option is ignored whenever the program executing the dump has the TODISK or TOPRINTER bit set in its OPTION task attribute. Otherwise, it operates as follows:

When you want to print the program dump contained in the PDUMP file, you must run SYSTEM/DUMPANALYZER to process that file.

NOFETCH (option 19)

If this option is set, you need not enter an OK (Reactivate) command to reactivate a WFL job containing a FETCH statement.

RESOURCECHECK (option 20)

If this option is set, resource limits established by queues are enforced (refer to the tape specification parameter in the MQ (Make or Modify Queue) command. Before jobs are admitted into queues, the RESOURCE task attributes are checked to ensure they do not exceed the established limits. If the option is reset, the limits are ignored. Refer to the Task Management Programming Guide for a detailed explanation of this option.

DRTRRESTRICT (option 21)

If this option is set, the system time or date cannot be changed by the DR (Date Reset) command, the TR (Time Reset) command, or the corresponding SETSTATUS calls. However, the TR command or call is permitted to change the time zone.

DIRDEBUG (option 22)

CATALOGING (option 23)

The CATALOGING option is tested during disk initialization after a halt/load. If this option is set, the CATALOGLEVEL attribute is initialized to the value of the system option CATALOGLEVELSET; if it is reset, CATALOGLEVEL is set to 0. Refer to the SYSOPS (System Options) command for more information.

OKTIMEANDDATE (option 24)

This option requires you to verify the system TIME and DATE values at halt/load time.

If the option is set, the system displays the current TIME and DATE settings on the ODT after a halt/load, and you must enter TIMEOK in response to the message PLEASE VERIFY TIME AND DATE to resume normal processing. To correct TIME or DATE before entering TIMEOK, use the DR (Date Reset) or TR (Time Reset) commands.

If you reset this option, but the hardware that maintains the system time of day was reinitialized, or the time was set at the console by an operator before a halt/load, or the system date does not match the console date, an OK_TIME_AND_DATE job waits asynchronously for you to reply with an OK response. Normal processing continues.

MOREBACKUPFILES (option 25)

This option controls the maximum number of printer backup files that can be created by any one task. If MOREBACKUPFILES is set, a single task can create up to 549,755,813,888 printer backup files. If MOREBACKUPFILES is reset, a single task can create up to 1000 printer backup files.

For a description of the backup file naming convention and the affect that MOREBACKUPFILES has on it, refer to the I/O Subsystem Programming Reference Guide.

LOGPOSITIONING (option 26)

When a parity I/O error on a tape occurs, the system tries to recover from the error by repositioning the tape and retrying the I/O process. If this option is set, the system logs these I/Os. If an I/O error occurs during the repositioning of a tape, you can use the log records that are written to analyze why the recovery was not successful.

SERIALNUMBER (option 27)

If this option is set, scratch tapes are not assigned to output files unless the file SERIALNO attribute matches the tape serial number, or the file SCRATCHPOOL attribute matches the scratch pool of a scratch tape, or the tape is specified in an OU (Output Unit) command.

ARCHIVING (option 28)

This option enables the archiving function of the catalog subsystem. If this option is set and the catalog level of the system is greater than 0 (zero), an archive log is created. The name of the archive log is ARCHIVELOG/<date>/<time>, where <date> and <time> are the creation date and creation time of the file, respectively. If the archive log cannot be set up, the system automatically resets the option.

CDRUNITNUMBER (option 29)

If this option is set to true, assignment to a scratch CD-disk occurs only if the unit number for a specific device is specified using the file attribute UNITNO or if the unit number is specified in an OU (Output Unit) command.

LIBRARYDEBUG (option 30)

IORANGECHECK (option 31)

This option verifies that the disk address requested for an I/O is within the range of one of the areas of the file. For IORANGECHECK to have any effect, the compile-time option DIAGNOSTICS must be set when the system is being compiled.

DATEBACKUPFILES (option 32)

If this option is set, a node consisting of 12 digits is added to printer backup filenames. The 12 digits represent the date and time that the task which created the file was initiated. The format of the 12 digit node is: YYYYMMDDHHMM. The first 8 digits represent the date, where YYYY is the year, MM is the month, and DD is the day. The remaining 4 digits represent the time, where HH is the hour and MM is the minute.

For a description of the backup file naming convention and the affect that DATEBACKUPFILES has on it, refer to the I/O Subsystem Programming Reference Guide.

KEYEDIOII (option 33)

Setting this option ensures that all new files created with FILEORGANIZATION = VALUE (INDEXED), VALUE (INDEXEDNOTRESTRICTED), or VALUE (KEYEDIOII) are linked to the SYSTEM/KEYEDIOII library and are created as KEYEDIOII files. Existing files are correctly linked to either SYSTEM/KEYEDIO or SYSTEM/KEYEDIOII depending on how they were created. Therefore, you can read and update both KEYEDIO and KEYEDIOII files, but all new files are KEYEDIOII.

Resetting this option ensures that all new files created with FILEORGANIZATION = VALUE (INDEXED) or VALUE (INDEXEDNOTRESTRICTED) are linked to the SYSTEM/KEYEDIO library and are created as KEYEDIO files. Existing files are correctly linked to either SYSTEM/KEYEDIO or SYSTEM/KEYEDIOII depending on how they were created. KEYEDIOII files are created only when the FILEORGANIZATION is explicitly set to VALUE (KEYEDIOII). Otherwise, a KEYEDIO file is created.

MIRRORING (option 34)

This option allows disk mirroring to occur after the next halt/load. At that time, a mirror information table (MIT) and other structures needed for disk mirroring are created.

Mirrored sets are allowed to come online only if the MIRRORING option was set before the last halt/load, and it has remained set.

The option can be changed, subject to the following conditions:

DIAGNOSTICDUMP (option 35)

If set, this option enables certain other memory dump calls to be made for diagnostic purposes. Also, the system provides maximum diagnostic information when an exception condition occurs.

AUDIT (option 36)

FILESATURATION (option 37)

If set, this option causes the following warning message to be issued whenever the system allocates the last area of a disk file:

WARNING, ALLOCATING LAST ROW OF FILE <file name>

The preceding message is subject to the following restrictions:

For information about how the system determines the last possible area of a disk file, refer to the LASTACCESSIBLEAREA description in the File Attributes Programming Reference Manual.

EOTSTATISTICS (option 38)

If this option is set, end-of-task (EOT) statistics for each task are displayed on the ODT in the following format:

<mix number> EOT TIMES: ET=hhh:mm:ss.s
 PT=hhh:mm:ss.s IO=hhh:mm:ss.s

In this display, hhh denotes the hours, mm denotes the minutes, and ss.s denotes the seconds (rounded to the nearest tenth).

STRICTSCHED (option 39)

The STRICTSCHED option alters the behavior of SF 3 (FACTOR). Refer to the SF (Set Factor) command for details.

NETRECOVERY (option 40)

If this option is set, during halt/load processing the system determines the last state of the currently selected BNA. If the state was not running, BNA is not initiated. If BNA was running before the halt/load, BNA libraries and stacks are initiated.

GRAPHDEBUG (option 41)

The GRAPHDEBUG option enables the tracing of diagnostic information about stack search graph additions, deletions, search actions, and stack termination prevention actions. A process called GRAPHDEBUG_LOGGER, which writes the trace information into the log, is active while this option is set. The processor and memory requirements for this option are minimal.

PBTUNLOAD (option 42)

This option allows an installation to specify that each printer backup file should be on a separate tape volume.

If this option is set (OP + PBTUNLOAD), printer backup tapes being created are unloaded when the file is closed. Thus, each printer backup tape file requires a separate tape volume.

If this option is reset (OP - PBTUNLOAD), printer backup tapes being created are left uptape when the file is closed. Thus, multiple printer backup tape files can be written to the same tape volume.

IODIAGNOSTICS (option 43)

PORTDEBUG (option 44)

If this option is set on an operating system that was compiled with the compile-time option INTERNAL set (a diagnostic system), port debug trace information is written to the SYSTEM/SUMLOG file in BNA debug log records. You can examine this information by running LOGANALYZER.

USECATDEFAULT (option 45)

The value of this option has meaning only on an operating system that is running CATALOGING. If this option is set, the default value of the file attribute USECATALOG is TRUE.

CATTEST (option 46)

MCPTEST (option 47)

Examples

Example 1

The following example shows the response to a simple OP command. Options that have an asterisk (*) next to them are set; all others are reset.

OP

   1 OPEN             2*TERMINATE         3 NOCHECK           4*LPBDONLY
   5*AUTORM           6 DIAGNOSTICS       8*AUTORECOVERY      9 DUPSUPERVISOR
  10 DUPINTRINSICS   11 TRANSWARNINGS    12*AUTODC           13 NODUMP
  15 AUTORUNNING     16*CRUNCH           17 BACKUPBYJOBNR    18 PDTODISK
  19*NOFETCH         20 RESOURCECHECK    21 DRTRRESTRICT     22 DIRDEBUG
  23*CATALOGING      24*OKTIMEANDDATE    25 MOREBACKUPFILES  26*LOGPOSITIONING
  27*SERIALNUMBER    28*ARCHIVING        29 CDRUNITNUMBER    31 IORANGECHECK
  33*KEYEDIOII       34*MIRRORING        35*DIAGNOSTICDUMP   36 AUDIT
  37 FILESATURATION  38 EOTSTATISTICS    39 STRICTSCHED      40*NETRECOVERY
  41 GRAPHDEBUG      42 PBTUNLOAD        43 IODIAGNOSTICS    44 PORTDEBUG
  45 USECATDEFAULT   46 CATTEST          47 MCPTEST

Example 2

This example shows the display for a status query of option 1:

OP 1

  1 OPEN RESET

Example 3

This example displays all reset options:

OP -

  ------------------------------- RESET OPTIONS --------------
   1 OPEN              3 NOCHECK           6 DIAGNOSTICS
   9 DUPSUPERVISOR    10 DUPINTRINSICS    11 TRANSWARNINGS
  13 NODUMP           15 AUTORUNNING      17 BACKUPBYJOBNR
  18 PDTODISK         20 RESOURCECHECK    22 DIRDEBUG
  25 MOREBACKUPFILES  31 IORANGECHECK     36 AUDIT
  37 FILESATURATION   38 EOTSTATISTICS    39 STRICTSCHED
  41 GRAPHDEBUG       42 PBTUNLOAD        43 IODIAGNOSTICS
  44 PORTDEBUG        45 USECATDEFAULT    46 CATTEST
  47 MCPTEST    

Example 4

These commands set or reset particular options:

OP + 3

   3 NOCHECK SET

OP - 3

   3 NOCHECK RESET