Commands SAVE thru SHUTQ

The SAVE command saves a temporary file by converting it to a permanent file in the system file domain. This command is necessary when the subsystem or program that created your file does not allow you to save it while the program is executing.

You must specify a new filename for $OLDPASS, because MPE/iX does not allow $OLDPASS as a permanent file name. If there is a file in the temporary domain with the same name specified by newfilereference, MPE/iX attempts to save $OLDPASS by creating a new temporary file. This temporary file name, created by SAVE, starts with S and is followed by seven digits: Sdddhhmm, where ddd is the Julian day of the year, hh is the hour of the day, and mm is the minute. The new temporary file is then saved under the file name specified by newfilereference, and is deleted from the temporary domain. If both temporary and permanent files exist under the same name specified by newfilereference, the temporary SAVE file is saved as a permanent file. In this case, a printed error message states the file name for the new SAVE file. It can be renamed later using the RENAME command.

This command applies only to temporary files on disk. It is similar to opening a file with the FOPEN intrinsic, and then closing it with the FCLOSE intrinsic, using a permanent file disposition.

Use the SAVE command to save KSAM XL files. Since the KSAMUTIL utility is not supported for KSAM XL, the SAVE command is the only method of doing so.

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.

To save the temporary file $OLDPASS, containing an object program, to the program file PROGFILE, enter:

 SAVE $OLDPASS,PROGFILE

To save the temporary file TEMPFL as a permanent file with the same name, enter:

 SAVE TEMPFL

To save the temporary file DATAFILE in the group GROUPX, enter:

 SAVE DATAFILE.GROUPX

To save a temporary file (other than $OLDPASS) and change its name, use the SAVE and RENAME commands. Only the logon group and account directories in the current session are searched, for example:

 SAVE DATAFILE
 RENAME DATAFILE,DATABASE

You can enter this command from a session, a job, a program, or in break mode. Pressing Break does not affect this command.

This command starts the segmenter subsystem from MPE/iX. The segmenter subsystem performs the intermediate functions between source code compilation and program execution.

The segmenter employs temporary files named T999SYM, SEGTMP01, and SEGTMP00. If you create temporary files with these names, the segmenter attempts to purge them.

You must have READ and LOCK access to use a relocatable library with the SEGMENTER command.

This command may be issued from a session or a job. It may not be issued in BREAK or from a program, unless the user or the MPE segmenter has process handling (PH) capability. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution.

To call the MPE segmenter from a session and transmit the output to a line printer instead of the standard list device, enter:

 FILE LISTFL;DEV=LP
 SEGMENTER *LISTFL

The SET command specifies several elements of the command interpreter including the terminal echo and baud rate.

In a job, the SET command can be placed anywhere between the JOB and EOJ statements. It is most practical to place it at the end of a job stream since the command does not execute if the job fails. $STDLIST then prints, allowing you to study your listing and to locate the problem. The effect of a SET
STDLIST=DELETE can be reversed by entering SET STDLIST=SAVE into the job stream. Note that the SET command works only on jobs with a spooled $STDLIST.

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.

The following example illustrates using the SET command from within a program:

 !JOB EXAMPLE, USER.TECHPUB,XGROUP
 !CONTINUE
 !RUN UPDATE.PUB.SYS;PARM=1;MAXDATA=16000
 !IF JCW < FATAL THEN
 !SET STDLIST=DELETE
 !ENDIF
 !EOJ

The SETCATALOG command allows you to catalog user-defined commands.

When you set your own UDCs, the change takes place in your UDC catalog immediately. If you specify the ACCOUNT or SYSTEM parameter, your UDC catalog is changed immediately, but other users in your account or system must log on again in order to have those changes available to them. If you set a UDC and specify another user (USER=), that user must log on again in order to have the changes available.

The ability to delete or append files is particularly useful because, although most UDC files do not change, new UDC commands are frequently added or modified. Using the DELETE or APPEND parameter allows you to make changes without incurring the overhead of recataloging the entire directory for every change. Grouping UDC files into functions further reduces the work involved in modifying UDCs.

The RECURSION option relieves the user of having to define a particular command more than once in a catalog set, and from having to maintain a particular order for commands within a catalog set. Refer to the discussion on options in "User Commands" in Using the HP 3000 Series 900: Advanced Skills.

If SETCATALOG is used in a UDC, all valid commands through and including the SETCATALOG command execute. But execution of the UDC terminates after the execution of the SETCATALOG command. Commands that follow do not execute. The SETCATALOG command does not have this effect when executed in a command file.

The SETCATALOG command may be invoked only from the logon command interpreter (user main), where it is passed through the scanner/parser. . It cannot be invoked from any other program (any child process).

This command is available in a session, job, or in BREAK. It is not available from a program. Pressing Break has no effect on this command.

The following command sets the UDC directory for the user JOHN.WORKERS with the commands in the file named UDCA. The USER option cannot be specified with the ACCOUNT or SYSTEM options. Attempting to do so produces an error.

 SETCATALOG UDCA; USER=JOHN.WORKERS

The following two command sequences are equivalent:

 SETCATALOG UDCA, UDCB
 
 SETCATALOG UDCA
 SETCATALOG UDCB ;APPEND

In the first example, the command has an implied RESET, and thus overwrites the previous file set in the directory. In the second example, UDCA is entered into the directory, and then UDCB is appended to the directory without affecting UDCA. It also finds new logon commands if appropriate.

The following command deletes UDCA from the directory at the account level, provided it was cataloged at the account level. If other account-level UDCs reside in the directory along with UDCA, they remain undisturbed by this deletion. When appropriate, a new logon UDC is set up.

 SETCATALOG UDCA ;DELETE ;ACCOUNT

	NOTE: It is not a good practice to create UDC's which have the same name as other files, especially command files or any other files your users may confuse with UDC's. If you enter a fully qualified file name that has the same name as an existing UDC, the group and account part of the fully qualified name are passed to the UDC as a parameter. For example, if COMM is a UDC, entering COMM.GROUP.ACCT will cause .GROUP.ACCT to be passed to COMM as a parameter even if COMM.GROUP.ACCT is a separate file.

The SETCLOCK command is used to change the system time or to change the system's time zone.

Changing the system time or time zone does not affect any interval timers in effect. Thus, a PAUSE for a given time duration will maintain that same duration regardless of how the system time is changed.

Changing the system time or time zone will cause any jobs streamed with a time specification (;AT=, ;DAY=, ;DATE= or ;IN=) to be introduced in accordance with the newly-changed system time. Thus, a job streamed with ;AT=9:00 will be introduced when the changed system time is equal to 9:00.

The user may provide SETCLOCK with a date and time, a time correction, or a time zone. The Date-Time form, the Correction form, and the Time Zone form are mutually exclusive; for instance, the user may not provide specifications for both a time correction and a time zone in a single command.

The Date-Time and Correction forms of the command are intended for slight adjustments of the system time. For example, these forms would be used to move the time forward or backward slightly in order to keep the system time synchronized with an external time source. Both local and Universal (GMT) time are adjusted.

The Time Zone form of the command is intended for the larger time changes required to move the system to a new time zone, such as moving between Standard Time and Daylight Savings Time. This form of the command alters the local time without changing Universal Time.

Date-Time: If the Date-Time form of the command is used, the system time is adjusted to the specified date and time. This adjustment is gradual by default. It may be made immediate if ;NOW is specified and the user has System Manager (SM) capability.

Correction: If the Correction form of the command is used, the system time is adjusted forward or backward by the amount of the correction. This adjustment is always gradual.

Time Zone: If the Time Zone form is used, local time is adjusted to match that of the specified time zone. In addition, the system time zone offset is changed to reflect the new time zone.

The Use of The Time Zone Offset

On the HP3000 Universal Time (GMT) is calculated by starting with local time and adding or subtracting a time zone offset. When changing time zones (such as moving from Standard to Daylight Savings Time and back) the local time is altered, but this change must not affect Universal Time. To prevent Universal Time from being altered, both the local time and the system time zone offset must be adjusted. Therefore, using the Time Zone form of this command is the only way to accurately change time zones.

If the Date-Time or Correction form of the command is used, Universal Time will drift along with local time. Thus, the Date-Time and Correction forms of this command should only be used to adjust the clock for drift, not to change time zones.

Results of the Time Zone Form

This method of changing time zones ensures that no out-of-sequence time stamps will occur either in local time or in Universal Time.

How a Gradual Time Change Works

Whether the Date-Time or a Correction form is used, the default method of changing the time is to gradually speed up or slow down the system clock until the change is achieved. Thus, even when a previous time is requested, the system clock will still move forward, although at a slower pace than real time. This slower pace will continue until the desired time "catches up" with the system clock. Because of the system clock's forward motion, there will never be a case where two consecutive timestamps appear to be out of sequence and where system time appears to run backwards.

This change in clock speed is accomplished by establishing a system time correction which is gradually consumed. During this time the system clock speeds up or slows down as necessary. When the correction reaches zero, the system clock resumes its normal pace. The rate of the correction depends on the load on the system. The correction rate will be slowed down by frequent timestamp requests, file accesses and frequent operating system activity such as context switches. In general, the correction will take no longer than twice the requested time difference. For example, a request to slow down the clock by one hour will take a maximum of two hours to complete.

Results of the ;CANCEL Parameter

Any time during an on-going correction, issuing this command with the ;CANCEL parameter will immediately set the correction to zero and cause the system clock to resume its normal pace. Any previous correction will remain. When this option is used, the system will report the amount of correction which was cancelled.

How a System Time Change Affects Accounting Information

Changing the system time, even gradually, may cause accounting CONNECT-MINUTES to be distorted. Anyone logging on before the change and then logging off after the change is completed will have their accounting CONNECT-MINUTES data distorted; if the time change is forward, CONNECT-MINUTES will be increased by the amount of the time change, and if the time change is backward, CONNECT-MINUTES will be decreased by the amount of the time change.

Dangers in Using the ;NOW Parameter

The ;NOW parameter permits immediate forward or backward time changes. However, several dangerous situations can occur:

This list is only meant to include a few of the dangers associated with an immediate time change; this list does not represent all of the problems likely to be encountered. Therefore, if the ;NOW option must be used, it should be used only with a full knowledge of its effects on the system's workload.

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.

Diagnostician (DI) and either Operator (OP) or System Manager (SM) capabilities are required to issue this command. Additionally, System Manager (SM) capabiltiy is required to use the ;NOW parameter.

The following example illustrates setting the system time by providing a date and time:

 :SETCLOCK DATE=07/04/1993;TIME=15:00

The following example illustrates providing a time correction to advance the system time by one hour.

 :SETCLOCK CORRECTION= +3600 

or

 :SETCLOCK CORRECTION= 3600 

Both of the above examples cause Universal Time (GMT) to change as well as local time, and therefore while they are useful in correcting the system time for drift (time gain or loss), they are not accurate ways to change time zones.

The following example illustrates setting a time correction, executing a SHOWCLOCK command, cancelling the correction, then again executing a SHOWCLOCK command. Note that by the time of the first SHOWCLOCK the correction has already begun to be consumed.

 :SETCLOCK CORRECTION= -3600 
 
 :SHOWCLOCK
 
 SYSTEM TIME: FRI, JUL 24, 1987, 8:47:35 AM
 CURRENT TIME CORRECTION: -3568 SECONDS
 TIME ZONE: 7 HOURS 0 MINUTES WESTERN HEMISPHERE
 
 :SETCLOCK; CANCEL
 
 CORRECTION OF -3550 SECONDS HAS BEEN CANCELLED
 
 :SHOWCLOCK
 
 SYSTEM TIME: FRI, JUL 24, 1987, 8:52:53 AM
 CURRENT TIME CORRECTION: 0 SECONDS
 TIME ZONE: 7 HOURS 0 MINUTES WESTERN HEMISPHERE

Note that in the example above the system clock was slower than normal for several minutes. Cancelling the correction did not undo that change; it merely prevented any further time change. Thus after this sequence of commands, the system clock is set to a slightly earlier time than if no SETCLOCK command had been issued.

Moving from Standard Time to Daylight Savings Time:

The following example illustrates changing the system time zone offset from 8 hours 00 minutes in the Western Hemisphere (Pacific Standard Time) to 7 hours 00 minutes in the Western Hemisphere (Pacific Daylight Savings Time). This command will cause local time to jump forward immediately one hour. Universal Time will be unchanged.

 :SETCLOCK TIMEZONE=W7:00
 
 SYSTEM TIME: SUN, APR 4, 1993, 7:12:00 AM
 CURRENT TIME CORRECTION: 3600 SECONDS
 TIME ZONE: 7 HOURS 0 MINUTES WESTERN HEMISPHERE

Moving from Daylight Savings Time to Standard Time:

The following example illustrates changing the system time zone offset from 7 hours 00 minutes in the Western Hemisphere (Pacific Daylight Savings Time) back to 8 hours 00 minutes in the Western Hemisphere (Pacific Standard Time). This command will cause local time to slow down until it loses one hour. Users of Universal Time will see an immediate one-hour jump forward, followed by a slowdown until system Univeral Time again matches real Universal Time.

 :SETCLOCK TIMEZONE= W8:00
 
 SYSTEM TIME: SUN, OCT 31, 1993, 06:23:14 AM
 CURRENT TIME CORRECTION: -3600 SECONDS
 TIME ZONE: 8 HOURS 0 MINUTES WESTERN HEMISPHERE

The SETCOUNTER command allows you to specify limits other than 1 and the maximum possible value of one of four counters (but within that range) You may set limits for one counter with each use of the command and, therefore, you must invoke the command four times to change the limits of all four coutners.

You may also use SETCOUNTER to display the current values of the counters. Only one invocation of the command is necessary to see all current values.

To set a maximum operating value for the specified counter and enable its operation, enter a positive value for the MAX keyword. Specify MAX=0 to disable the operation, that is, the counter's limit is then its maximum possible value. Omitting MAX leaves its previous value in force. Once MAX is reached, the next value tried is the BASE value. If you specify a non-zero value for MAX, it must be greater than the current BASE for the corresponding counter, but less than the maximum possible value

The BASE keyword causes the specified counter to be immediately yanked to the specified value. If you supply a value, it must be less than the supplied or current value of MAX (other than 0), and in any case, less than the maximum possible value. If you do not specify BASE, it is not changed, nor is current sequencing affected.

For each counter, duplicate values are avoided. For example, if #O10 is in use when due to be assigned as the next output spoolid, it is skipped and #O11 is tried. This process continues until an available value is found.

The defaults, established when the system is booted, are MAX=0 and BASE=1. This is for backward compatibility; if these settings are not changed, the system will operate as it does today. These boot time settings can be modified by including one or more instances of this command in SYSSTART.PUB.SYS.

The SHOW option can be used alone to display the current values of BASE and MAX for a specified counter or for all four counters. If used in addition to either BASE or MAX, the value(s) displayed are the new setting(s).

This command may be issued from a session, job, program, or in Break. Any display specified by the SHOW option is breakable, but command operation is not. Any user may execute this command with only the SHOW option to display current values of BASE, Next, and MAX for the specified counter (or all counters if none is specified). When changing either value, this command may be executed only:

To display the current BASE, Next, MAX, and maximum possible values for all four counters, enter:

 :SETCOUNTER ; SHOW
                                              Absolute      
   COUNTER          BASE     Next      MAX    maximum      
              
 Input spoolid        1      172     16383    9999999     
 Output spoolid       1     1872     32767    9999999     
 Job number           1      172         0     16383     
 Session number       1     2753         0      16383     

To limit input spoolids to the same range as their corresponding jobs, enter:

 :SETCOUNTER INSP; MAX=16383

This command enables the stackdump facility for any process created later under the current session or job. If the call is armed (enabled), and the process aborts, SETDUMP executes the system debug commands given in the "commands" parameter.

If no commands are specified, a default command string is used to produce a stacktrace and register dump.

If the process is interactive, it subsequently enters the system debugger to wait for further commands. If it is not interactive, the process simply terminates instead of entering the debugger.

Any combination of the four strings (DB, ST, QS, or ASCII) is parsed without error in MPE/iX, but they have no effect on the functional behavior of the commands. The "commands" string, preceded by the DEBUG keyword, is interpreted as a series of system debug commands and is sent to the system debugger that way.

The "commands" parameter may contain a maximum of 255 characters.

	NOTE: The DB, ST, QS, and ASCII parameters are retained for compatibility reasons. These parameters are ignored.

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.

To arm the stackdump/debug facility, enter:

 SETDUMP

A job control word (JCW) is a flag that allows information to be passed between processes within a single job or session. There are three forms of JCWs: system-defined, user-defined, and system-reserved.

Job control words in MPE/iX are classed as system variables of type JCW. You may delete user-created variables. You may modify the two system-defined variables CIERROR and JCW. Refer to appendix A, "Predefined Variables in MPE/iX," for a list of system-defined variables.

The SETVAR command creates and assigns variables too, but variables created or assigned with SETVAR are not of type JCW and cannot function as true job control words.

If you create or assign a value to a variable using the SETJCW command and later reassign its value using the SETVAR command, the reassignment succeeds. If the new value is out of range for a JCW, the variable type is changed to that of an ordinary user-defined variable:

  SETJCW PROGCNTR 0
 ....
  SETVAR PROGCNTR 65536
 JCW VARIABLE RECLASSIFIED AS A STANDARD VARIABLE
 (CIWARN 8126)

PROGCNTR is now a user-defined variable and does not function as a job control word.

JCWs can be tested against specific values. The user can use IF and WHILE conditional statements that act according to the results of these tests. The user-defined JCWs can also be set to user-selected values by a process so that they reflect the completion of steps within that process. System-defined JCWs can be used to determine whether certain events have occurred within MPE/iX.

The values in the system-reserved JCWs can be inspected by the user, but not altered.

To display the contents of a JCW use the SHOWJCW or the SHOWVAR command.

JCW Values and Mnemonics

JCWs may be assigned any positive integer value between 0 and 65,535 inclusive (%0 and %177777). These values are treated as 16-bit unsigned integers by MPE/iX, since all 16 bits are used for numeric information, rather than using the most significant bit as a sign bit.

MPE/iX treats the two most significant bits of a JCW in a special way: the bits define "bases" or "steps" of 16K each. Each of these steps is given a mnemonic to simplify references to it or to the numbers between steps. If the 14 least significant bits are considered to be zeros, the two "step" bits, step value (in decimal), and mnemonic have the following relationship:

It is important to remember that these mnemonics are not the names of JCWs. They cannot be used as user-defined JCW names.

You may use a combination of mnemonics and numbers to indicate numeric values between steps. If you specify a mnemonic and a number with no intervening spaces, an implied addition takes place. For example, WARN3 has a value of 16,387, since it is WARN (16,384) plus 3. The value of the mnemonic plus the appended number value may not exceed 65,535. Again, no valid value of the form, mnemonic[number], may be used as a valid user-defined jcwname. An explicit addition or subtraction can also be specified, using a + or - sign, as in OK+7 (7) or WARN-4 (16,380). A mnemonic may also be added to another mnemonic, as in WARNFATAL.

The result of a mathematical operation must be in the range of 0 to 65,535, inclusive; if the number is out of range, an error message is generated, and the value of the JCW remains unchanged. When the result of an operation is greater than the value of the next "step", the JCW value displayed by the SHOWJCW command will be the mnemonic of the higher step plus any offset. For example, the value OK16385 is displayed as WARN1.

User-Defined JCWs

User-defined JCWs are created and initialized to a value by the SETJCW command or PUTJCW intrinsic. The JCW name contains alphanumeric characters and must begin with an alphabetic character. The name can be up to 255 characters long. The value assigned to the JCW must be in the range of 0 to 65,535, inclusive.

The SETJCW command scans the MPE/iX variable table for the name of the specified JCW (jcwname). If the specified name is found, the JCW is set to value. If the jcwname is not found, it is created and set to value. The term "value," as used here, means the explicitly stated or the computed value.

You may not begin a JCW name with the mnemonic names OK, WARN,
FATAL, or SYSTEM, unless you append a number to the mnemonic such that the computed value exceeds 65,535 (for example, WARN999999, or SYSTEM200000). If the computed value exceeds 65,535, MPE/iX does not recognize the term as a valid mnemonic, and treats it as the name of a JCW. This restriction is intended to eliminate the possibility of an ambiguous JCW assignment. For example, it is unclear from the following two commands whether the JCW X is equal to 100 or to 0:

 SETJCW OK=100
 SETJCW X=OK

Naming a JCW with a mnemonic or predefined JCW value results in an error message, as in the following example:

  SETJCW OK200=1982
 JCWNAME CANNOT BE A VALID JCW VALUE (CIERR 1725)

Negative or out-of-range JCW values cause the following error message to be displayed:

 VALUE NOT IN RANGELEGAL RANGE IS 0 TO 65535 (CIERR 1712)

System-Defined JCWs

JCW and CIERROR are MPE/iX system-defined JCWs created for each job and session. The JCW named JCW is always initialized to zero at the beginning of the job or session and remains zero, unless fatal errors occur, or unless the user changes the value. There are two special values for the system-defined JCW:

 %140000 (System 0) Program aborted per user request.
 
 >%140000      Program terminated in an error state.

The CIERROR JCW tracks command interpreter (CI) errors.

CIERROR is set to zero at the beginning of the job or session. If a command interpreter error occurs, CIERROR is updated to reflect the current CI error message number.

Users are advised not to alter the values of the CIERROR and JCW job control words. User-defined JCWs should be used for information the user wishes to control.

The following example shows the use of the CIERROR JCW:

  LISTF
  ^
 UNKNOWN COMMAND NAME. (CIERR 975)
  SHOWJCW CIERROR
 CIERROR = 975 
  RUN
    ^
 NO PROGRAM FILE SPECIFIED. (CIERR 600) 
  SHOWJCW CIERROR
 CIERROR = 600 
 : 

System-Reserved JCWs

The system-reserved JCWs are HPMINUTE, HPHOUR, HPDAY, HPDATE, HPMONTH, and HPYEAR. They contain system-assigned minute, hour, day, date, month, and year information. If the user attempts to assign values, an error message is displayed. You can retrieve the values in these JCWs with the FINDJCW intrinsic. The values can also be tested if the JCW is used with an IF, WHILE, SETJCW, SETVAR, or CALC command. The names of the system-reserved JCWs are reserved.

The following describes system-reserved JCWs and possible values:

Conditional Execution Using JCWs

JCWs are typically used to control the flow of batch jobs, based on events that take place within the job. You can use the MPE/iX IF/THEN (ELSE/ELSEIF), ENDIF, and WHILE/ENDWHILE statements to test JCW values.

The following example illustrates a conditional execution function. The sample job runs a program that edits, verifies, and counts valid transactions (CHEKPROG). If no fatal errors occur, the job runs the program SHIPPROG, which schedules shipments. The job then runs FINALRPT, which produces a final report. If fatal errors do occur, the CHEKPROG sets the value of the JCW CHEKPROGSTAT to FATAL, and SHIPPROG is not run. Instead, ERRORRPT is run, which produces an error report. A final report is also produced by FINALRPT.

You can use the SHOWVAR command to display the value of any specified variable or any group of variables, including JCW type variables. You can display the contents of a system-defined JCW with the SHOWJCW command only if you specify the jcwname.

In the following example the CONTINUE command prevents an abort in case of errors; the RUN CHEKPROG edits, verifies, and counts valid transactions; the IF command specifies that if no fatal errors occur, schedule shipments; the RUN command schedules the shipments; the ELSE command produces the error report and resets the JCW to 0; and the RUN command produces a final report:

 !SETJCW CHEKPROGSTAT=OK
 !CONTINUE
 !RUN CHEKPROG
 ! IF CHEKPROGSTAT<FATAL THEN
 !  RUN SHIPPROG
 ! ELSE
 !  SHOWJCW CHEKPROGSTAT
 !  RUN ERRORRPT
 !ENDIF
 !RUN FINALRPT

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.

To set the job control word CURR1 to 100, and use a comma (,) as the delimiter instead of an =, enter:

 SETJCW CURR1,100

To set CURR1 to the value of the mnemonic WARN, and use a slash (/) as the delimiter instead of an =, enter:

 SETJCW CURR1/WARN

To use an arithmetic operation to set one JCW value relative to another, enter:

 SETJCW NEWJCW=LASTJCW + 56

To schedule a full backup job on Saturdays and a partial backup job on the other days of the week, you could create a user command:

 SETJCW FRIDAY=6
 IF HPDAY = FRIDAY THEN
     SCHEDJOB FULLBKUP;IN=1
 ELSE
     SCHEDJOB PARTBKUP;IN=1
 ENDIF

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.

Allows a job or session to receive or block TELL messages from other users. WARN messages from the system operator override quiet mode and are received and displayed.

To block messages, enter:

 SETMSG OFF

To receive messages, enter:

 SETMSG ON

This command assigns values to MPE/iX variables. Variable names may be any combination of letters and numbers plus the underbar character, up to a total of 255 characters. Variables must start with a letter or the underbar character.

The expression parameter may be an MPE/iX expression, a Boolean, integer, or string value, or the name of another variable. If expression consists of elements and operators MPE/iX accepts ('abc' + 'cd' or 2*5+1), SETVAR will evaluate it. The operators defined in Table 12-2 “Logical Operators - The SETVAR Command” may be used in expression.

The allowed operands are any variable, integer constant (hexadecimal ($), octal (%), or decimal) quoted string constant, the Boolean constants TRUE and FALSE, or the JCW mnemonics (SYSTEM, FATAL, for example, as defined in the SETJCW command).

Note that all variables are global, so the CI variable name should not be the same as the JCW name that is being used or the operation of the code that uses that JCW will be affected.

Compound logical expressions can be formed using the AND, NOT, XOR, and OR logical operators, and nested within parentheses.

The Boolean value of the keyword TRUE or FALSE is overridden if there is a variable of the same name. For example, to store the string value 'ABC' in X, enter:

 SETVAR TRUE 'ABC'
 SETVAR X TRUE

The SETVAR command may be used to set the command interpreter's search path (HPPATH), the command interpreter's prompt (HPPROMPT), and all other variables. You use SHOWVAR to see all the variables that were created by the user. Issuing SHOWVAR @ causes the display of every predefined and user-defined variable.

This command may be issued from a session, job, program, or in BREAK. Pressing Break terminates an INPUT ( ) function.

To change the command interpreter prompt to your username.accountname, enter:

 SETVAR HPPROMPT "!HPUSER.!HPACCOUNT:" or
 
 SETVAR HPPROMPT HPUSER+"."+HPACCOUNT+":" 

The result is the same regardless of which form of the command you use.

This command generates the status information of the specified system tables and lists files which are allocated.

This command requires system manager (SM) capability to execute for other groups or accounts.

To display status information for all allocated files in the system.

 SHOWALLOCATE ALLOCATE
 
     ALLOCATED PROGRAMS         SHARE COUNT
     
      EDITOR.PUB.SYS . . . . . . . .    0
      FCOPY.PUB.SYS  . . . . . . . .    2
      LISTDIR5.PUB.SYS . . . . . . .    1
 
      NUMBER OF PROGRAMS FOUND = 3

To display status information for all allocated files starting with a character "S" in the account named SYS.

 SHOWALLOCATE ALLOCATE,S@.@.SYS
 
     ALLOCATED PROGRAMS         SHARE COUNT
     
      SPOOK5.PUB.SYS . . . . . . . .    1
      SLPATCH.PUB.SYS . . . . . . . .    0
 
      NUMBER OF PROGRAMS FOUND = 2

To display summary status information regarding allocation.

 SHOWALLOCATE STATUS
 
    ALLOCATION STATUS
 
      NUMBER OF PROGRAMS ALLOCATED = 3
 
      ALLOCATION RELATED TABLES      SIZE   %USED
      
      CODE SEGMENT TABLE              191    52
      CSTX BLOCK TABLE                144    13
      LOADER SEGMENT TABLE           32000    3

This command displays the operator commands that have been allowed to specific users if the user.acct form is entered. If the @.@ form is entered, the commands allowed to all users in all accounts are displayed. System manager (SM) capability is required to specify @.@. Account managers (AM capability) may specify all users in their own account. When SHOWALLOW is executed from the system console, @ may be substituted for user and/or acct. In addition, SHOWALLOW separately lists which operator commands have been globally allowed.

This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command. Account manager (AM) or system manager (SM) capability is required to execute this command for other groups or accounts.

To list the operator commands allowed to the user USER.SYS, enter:

  SHOWALLOW USER.SYS
 #S86 USER.SYS
   USER HAS THE FOLLOWING COMMANDS ALLOWED:
 ABORTIO     ACCEPT     DOWN     GIVE
 
 THERE ARE NO GLOBAL ALLOWS DEFINED.

This command lists user-defined command files, their commands and the level at which they were cataloged (user, account, or `system). This may not be the executing UDC catalog directory, as with the USER option. The user may specify a listfile to send the listing to the line printer. You may use a file equation to direct the listing of the catalog to another disk or tape file. Default is that the listing is sent to the $STDLIST device.

If SETCATALOG is performed with the USER option after the user logs on, the user's executing UDC directory is not affected. Only the UDC catalog set is affected. The next time the user logs on, the UDC directory is built from this set. Thus the SHOWCATALOG command with the USER option shows the UDC catalog set. The SHOWCATALOG command alone shows the currently executing UDC directory commands.

This command is available from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command.

To display the account-level UDC files of all users in the GRIMSBY account, enter:

 SHOWCATALOG ;USER=@.GRIMSBY

To display the system-level UDC files of all users in all accounts, enter:

 SHOWCATALOG ;USER=@.@

To display all UDC command files for the current user and send the listing to the line printer (LP), enter:

 SHOWCATALOG MYFILE

To display all UDC command files for the current user and send the listing to the disk file called MYFILE, enter:

 FILE MYFILE;DEV=DISK
 SHOWCATALOG *MYFILE

To send all system-level UDC files to the line printer under the name LISTALL, enter:

 SHOWCATALOG LISTALL,@.@

To display a list of the cataloged files for the user SCOTT in your account, enter:

 SHOWCATALOG,SCOTT

None.

Prints the current time, date, the time correction in effect, and the time zone. See the command SETCLOCK for information about time correction and time zone.

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.

The SHOWDEV command displays the status information for all input and output devices on the system. The display spacing is important and has been changed after the 4.7 release. The display appears in the following format:

  SHOWDEV
 
 Total number of blanks between items after release 4.7
 
    5     9         9       9    3
 LDEV   AVAIL     OWNERSHIP     VOLID     DEN  ASSOCIATION
   1   DISC     N/A
   2   DISC     N/A
   3   DISC     N/A
   4   DISC     N/A
   5   AVAIL
   6   SPOOLED    SPOOLER OUT
   7   AVAIL
   8   AVAIL
   9   AVAIL
  10  A AVAIL
  11   DISC     N/A
  12   DISC     N/A
  13   DISC     N/A
  14   DISC     N/A
  15   DISC     N/A
  16   DISC     N/A
  17   AVAIL
  18   AVAIL
  19   SPOOLED
  20  A UNAVAIL    #S914: 8 FILES
  21  A AVAIL

This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command.

To display the status of the device identified by logical device number 5 enter:

  SHOWDEV 5
 LDEV AVAIL   OWNERSHIP   VOLID  DEN  ASSOCIATION
  5  SPOOLED  SPOOLER OUT

To display the status of all devices of the device class CARD, enter:

  SHOWDEV CARD
 LDEV AVAIL   OWNERSHIP  VOLID  DEN  ASSOCIATION
 
  6 A AVAIL

This command displays the status information about one or more currently defined input device files. This information reflects the status at the time the command is entered, and always appears on the standard list device. Except for the keyword STATUS, which has its own format (refer to "Parameters"), the format of the information is as follows:

 DEV/CL DFID  JOBNUM FNAME  STATE   FRM SPACE RANK PRI #C
 10     #I10  #J133  $STDIN OPENED

The information displayed in this format is defined as follows:

This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command.

The following is an example of how to determine the status of an individual input device file:

  SHOWIN #I80
 
 DEV/CL DFID JOBNUM FNAME   STATE   FRM SPACE RANK PRI #C
 43     #I43 #S37  $STDIN   OPENED              8

If you do not know the device file identification number (DFID) of the device file whose status you want to determine, you may request the status display by entering either the logical device number or the device class name of the device on which the file originated:

  SHOWIN DEV=43
 
 DEV/CL DFID JOBNUM FNAME  STATE  FRM SPACE RANK PRI #C
 43     #I43 #S37  $STDIN  OPENED

You may also request displays of device file information using various combinations of qualifications (devices, jobs/sessions, and states). For example, to display information about all OPENED input device files used by all sessions (but not jobs) in the system, enter:

  SHOWIN JOB=@S;OPENED
 
 DEV/CL DFID JOBNUM FNAME   STATE FRM SPACE RANK PRI #C
 7      #I7  #S38  MASTER  OPENED
 26     #I26 #S18  $STDIN  OPENED
 32     #I32 #S41  $STDIN  OPENED
 34     #I34 #S26  $STDIN  OPENED
 42     #I42 #S28  $STDIN  OPENED
 43     #I43 #S37  $STDIN  OPENED
 50     #I50 #S40  $STDIN  OPENED
 51     #I51 #S17  $STDIN  OPENED
 8 FILES (DISPLAYED):
   0 SPOOFLES: 0 SECTORS

The SHOWJCW command is used to display the current state of one or more job control words (JCWs). Job control words in MPE/iX are classed as variables of type JCW. Specifying a particular JCW (user-defined, system-defined, or system-reserved) displays the value of that particular JCW. If you do not specify a particular JCW, user-defined and system-defined JCWs are displayed. The value of the third type of JCW, system-reserved JCW, is displayed only if you specifically enter its jcwname. The SHOWVAR command can be used to show variable values as well.

You may retrieve the value assigned a JCW with the FINDJCW and HPCIGETVAR intrinsics.

You may test the value of a JCW with an IF or WHILE command. In this way, the value of a given JCW can be used to conditionally execute another instruction or set of instructions. For example:

  !CONTINUE
  !SPL MYPROG,MYUSL
  !IF JCW>=FATAL THEN
  !  TELL USER.TECHPUBS;COMPILE FAILED
  !ELSE
  !  TELL USER.TECHPUBS;COMPILE COMPLETED
  !ENDIF

This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command.

To show the current state of all user-defined and system-defined JCWs, enter:

  SHOWJCW
 JCW = 0
 CIERROR = 0

To display the current state of a valid user-defined job control word named JCW1, enter:

  SHOWJCW JCW1
 JCW1=3

To display the contents of a system-reserved JCW, enter:

  SHOWJCW HPDAY
 HPDAY=4

If information for only one device file is displayed, output is in Type I format; if information for more than one device file is displayed, output is in Type I followed by Type II format. (Format types are described under "Operation Notes.")

This command enables you to determine the number of jobs and sessions in each processing state, the current jobfence and job/session limits, and allows you to keep track of individual spooled and streamed jobs that are entered in the system. The command jobq will indicate the queue name to which the job belongs.The output appears in the following formats:

Type I:

  JOBNUM STATE IPRI JIN JLIST  INTRODUCED JOB NAME
 
  #S16   EXEC     45  45   MON 7:08A TEST.PUBS
 
  JOBFENCE= 0; JLIMIT = 3; SLIMIT= 16

Type II:

  7 JOBS:
   0 INTRO
   0 WAIT; INCL 0 DEFERRED
   7 EXEC; INCL 7 SESSIONS
   0 SUSP
  JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16

If the SHOWJOB SCHED command is used, the output is displayed as shown below. The STATE field shows that the job is scheduled. The SCHEDULED-INTRO field shows the time and date the job will be introduced to the system. Note that the scheduled jobs are listed in the order in which they will be introduced to the system. If you enter only the SHOWJOB command, the formatted output for jobs and sessions in the INTRO, WAIT, and EXEC states is displayed first in the Type I and Type II formats. The formatted data for jobs in the SCHED state is displayed last and is in the Type III format.

Type III:

  CURRENT: 5/13/85 1600
 
  JOBNUM STATE IPRI JIN JLIST SCHEDULED-INTRO JOB NAME
 
  #J38  SCHED  3  10  6   5/16/84 11:24  NOTHING,JON.OSE
  #J23  SCHED  8  10  PP  5/25/84 8:01  REPORT,MGR.OSE
  #J25  SCHED  8  10  LP  7/ 4/84 18:05  FIREWORK,MR.SAM
 
  3 JOBS (DISPLAYED)
  JOBFENCE=7; JLIMIT=2; SLIMIT=20

This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command.

To determine the number of jobs and sessions in each processing state, the current jobfence and the job/session limits, enter:

  SHOWJOB STATUS
  6 JOBS:
    0 INTRO
    0 WAIT; INCL 0 DEFERRED
    6 EXEC; INCL 6 SESSIONS
    0 SUSP
  JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16

To get a report on all jobs and sessions in the system, enter:

  SHOWJOB
 
  JOBNUM  STATE IPRI JIN JLIST  INTRODUCED JOB NAME
  #S745  EXEC     29 29   MON 2:53P DL,SPL.ALANG
  #S746  EXEC     26 26   MON 2:53P CLI.AOPSYS
 
  2 JOBS:
    0 INTRO
    0 WAIT; INCL 0 DEFERRED
    2 EXEC; INCL 2 SESSIONS
    0 SUSP
  JOBFENCE= 2; JLIMIT= 1; SLIMIT= 16

:SHOWJOB;jobq

JOBNUM STATE IPRI JLIST JOBQ INTRODUCED JOB NAME #J3 EXEC LP HPSYSJQ WED 11:46A FTPMON,FTP.SYS #J7 EXEC LP SYSMGRQ WED 5:47P EMG,MGR.SYSMGR #S81 EXEC 34 THU 12:17P MGR.GOPI

The following example of a SHOWJOB command sequence illustrates an override of the default characteristics of listfile with the FILE command, and shows the output produced with the new listfile characteristics:

  FILE A;REC=40,1,F,ASCII;NOCCTL
  SHOWJOB;*A
  SAVE A
  FCOPY FROM=A;TO=
 
  HP32212A.03.26 FILE COPIER (C) HEWLETT-PACKARD CO. 1984
 
  MON, MAY 7, 1987, 7:54 AM
 
  JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME
  #S46  EXEC    20 20   MON 7:14A OPERATOR.SYS
  #S45  EXEC    47 47   MON 6:37A USER.PUBS
  #S47  EXEC    10S LP   MON 7:26A SUPPORT.DOC
  #S48  EXEC    102 102  MON 7:28A USER.TECH
  #J19  EXEC    28 28   MON 6:41A JON.OSE
  #S49  EXEC*    34 34   MON 7:31A FLASH.G
  #J21  EXEC    10S LP   MON 7:15A DELIVER,MAIL.MAIL
  #J22  EXEC    10S LP   MON 7:14A RSPOOLJ,RSPOOL.SYS
 
 8 JOBS (DISPLAYED):
   0 INTRO
   0 WAIT; INCL 0 DEFERRED
   8 EXEC; INCL 5 SESSIONS
   0 SUSP
 JOBFENCE= 6;  JLIMIT= 4;  SLIMIT= 50
 EOF FOUND IN FROMFILE AFTER RECORD 17
 
 18 RECORDS PROCESSED *** 0 ERRORS
 
 END OF SUBSYSTEM
 :

The SHOWJOB command reports a job or session as being in EXEC* when it is initializing. After initialization is complete, the state changes to EXEC. The number shown in the EXEC state is the sum of the jobs and sessions in both EXEC and EXEC*.

None.

The log file number, xxxx, and percentage of file space used, yy, is displayed in the format:

  SYSTEM LOG FILE #xxxx IS yy% FULL

If the logging system is disabled, MPE/iX displays the message:

  NO LOGGING

If logging is enabled but currently suspended due to an error, both messages are displayed.

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command. System supervisor (OP) capability is required to use this command.

To display the current log file status, enter:

  SHOWLOG
 
 SYSTEM LOG FILE #7 IS 20% FULL

This command lists the status of currently running logging processes. The status includes the total number of records written by the process and the number of users accessing the logging file. By default this command gives the following information about all currently running logging processes. To display the status of the logging identifier LEN, enter:

  SHOWLOGSTATUS LEN
 
  LOGID  CHANGE AUTO USERS STATE  CUR-REC  MAX-REC % USED CUR-F
 
  LEN    NO      NO   4  INACTIVE  100       1000  10%   1

The information provided in this format is defined as follows:

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.

Refer to "Operation Notes."

None.

To display the status of the current job/session enter:

  SHOWME
  USER: #S485,MGR.DSUSER,PUB   (NOT IN BREAK)
  RELEASE: V.UU.FF MPE XL HP31900 A.11.70 USER VERSION: V.UU.FF
  CURRENT: MON, MAY 7, 1987, 11:09 AM
  LOGON:  MON, MAY 7, 1987, 11:08 AM
  CPU SECONDS: 3     CONNECT MINUTES: 1
  $STDIN LDEV: 88     $STDLIST LDEV: 88

The system welcome message, if one exists, appears immediately following the SHOWME display. The information provided in the format above is defined as follows:

	NOTE: SHOWME calculates CPU usage by adding the local CPU usage of the current process to the accumulated total of all terminated processes. The CPU usage listed for a programmatic SHOWME, therefore, would rarely agree with that for a SHOWME executed during BREAK.

This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command.

Refer to "Operation Notes."

This command displays the status information for one or more currently defined output device files. The information reflects the status at the time the command is entered and always appears on the standard list device. Two types of spooling queues are maintained in MPE/iX, one output queue for each logical device configured on the system and one additional queue for all device classes. Within each queue, files are linked according to the following parameters and listed in descending order of importance by output priority, device class, and rank. If the priorities are equal, the spooler alternates between queues.

Information about all spoolfiles on the system is available only from the console. Information about spoolfiles created in a specific job or session is available during that job or session only.

To list information about an individual output device file, you may specify its device file identifier (DFID) in the SHOWOUT command:

  SHOWOUT #O26
 
  DEV/CL DFID  JOBNUM FNAME  STATE FRM SPACE RANK PRI #C
  EPOC  #O26  #J242 $STDLIST READY    36  D  1  1
 
  OUTFENCE = 6

The information provided in this format is defined as follows:

Type I:

  DEV/CL DFID JOBNUM FNAME   STATE  FRM SPACE RANK PRI #C
  32   #O32 #S16  $STDLIST OPENED
  OUTFENCE=6

Type II:

  19 FILES
  O ACTIVE
  2 READY; INCLUDING 2 SPOOFLES, 2 DEFERRED
  17 OPENED; INCLUDING 1 SPOOFLE
  0 LOCKED; INCLUDING 0 SPOOFLES
  3 SPOOFLES: 1572 SECTORS
  OUTFENCE = 6
  OUTFENCE = 2 FOR LDEV 13 

This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command.

To display the total number of output device files currently existing, the number of those that are spooled, and their current status, enter:

  SHOWOUT STATUS
  11 FILES:
    1 ACTIVE
    1 READY; INCLUDING 1 SPOOFLES, 0 DEFERRED
    9 OPENED; INCLUDING 1 SPOOFLES
    0 LOCKED; INCLUDING 0 SPOOFLES
    3 SPOOFLES: 7212 SECTORS
  OUTFENCE= 2
  :

You can also request information about a specific output device file, device number or device class name of the device for which the file is destined in the SHOWOUT command:

  SHOWOUT DEV=43
 
  DEV/CL DFID JOBNUM FNAME   STATE  FRM SPACE RANK PRI #C
  43   #O43 #S37  $STDLIST OPENED
 
  OUTFENCE= 2
  :

The SHOWPROC command displays information about processes except lockwords, which are never displayed. By default, the processes shown are the root CI and its descendents (TREE option). Any user may issue this command. Users with OP or SM capability may see information for processes belonging to other users. SM users may also see system processes via the SYSTEM option.

Any user may issue the SHOWPROC command and see information about all processes that belong to them. A process "belongs" to a user if one or more of the following conditions exists:

If rule 1 or 2 applies or the user has SM capability then all information (except lockwords) is visible. Otherwise, only the Command Interperter (CI) command and/or program names are shown. That is, the parameters of a CI command and the INFO= string passed to a program are not visible.

When SHOWPROC is executed in a job, regardless of capabilities and process ownership, only the CI command name and program are displayed.

If you specify both the ;PIN= and ;JOB= parameters, information for the list of pins will precede the information for the list of jobs. Duplicate specifications are not detected.

SHOWPROC may be issued from a Session, Job, Program, or in BREAK. Pressing Break aborts the execution of this command.

The fields displayed are described below. The field's width, in characters, is shown within parentheses. A "v" indicates that the field has a variable size width.

On the next page is a sample output of the DETAIL format. In this example, pin 2 is a system mode process, running linearly at priority 142. Pin 99 is a user mode process running linearly at priority 160. Pin 121 is a user mode process that is an artificial member of the "Payroll_Online" workgroup

 :SHOWPROC pin=(2,99,121,188);format=detail;system
 
  PIN PARENT  PRI  CPUTIME  STATE  JOBNUM (PROGRAM) STEP
 -  -   -   
  2 1     142 L  7:23.687 WAIT      (LOAD.PUB.SYS)
 
 LOGON     :
 PROGRAM    : LOAD.PUB.SYS
 QUEUE     : BS
 WORKGROUP   : BS_Default
 
 ***********************
 
 
  PIN PARENT  PRI  CPUTIME  STATE  JOBNUM  (PROGRAM) STEP
 -  -   -   
  99 68    160 L  0:05.020 BLKIO  S45  (QEDIT.PUB.SYS)
 
 LOGON     : NMTEST,SLC.MYTEST
 PROGRAM    : QEDIT.PUB.SYS
 QUEUE     : BS
 WORKGROUP   : Program_Development
 
 ***********************
 
 
  PIN PARENT  PRI  CPUTIME  STATE  JOBNUM (PROGRAM) STEP
 -  -   -   
  121 97    158 D  0:12.045 READY  J51   :tdp "text report"
 
 LOGON     : JREPORT,GREG.MYTEST
 PROGRAM    : TDP.PUB.SYS
 QUEUE     : DS
 WORKGROUP   : %Payroll_Online
 
 
 ************************
 
  PIN PARENT  PRI  CPUTIME  STATE  JOBNUM (PROGRAM) STEP
 -  -   -   
  188 101   100 D  0:04.200 WAIT   S56   (TDP.PUB.SYS) text test1
 
 LOGON     : CMTEST,DOUG.MYTEST
 PROGRAM    : TDP.PUB.SYS
 QUEUE     : BS
 WORKGROUP   : BS_Default

Below is a sample output of the default SUMMARY format. The information in the (PROGRAM) STEP column is visible only when the user issuing the command has SM capability, or when the process specified on the command line (in this case, #P54) belongs to the user.

 :SHOWPROC #P54; tree; trunc
 
 QPRI CPU    STATE JOBNUM PIN  (PROGRAM) STEP
 
 C152 0:12.999 WAIT S12   54  :tdp "text myfile"
 C152 0:02.000 WAIT S12    38  (TDP.PUB.SYS) text myfile
 C152 0:01.030 READY S12     67  (FCOPY.PUB.SYS)from=foo.pub.sys;to=b$
 
 
 :SHOWPROC #P54; tree; notrunc
 
 QPRI CPU    STATE JOBNUM PIN  (PROGRAM) STEP
 
 C152 0:12.999 WAIT S12   54  :tdp "text myfile"
 C152 0:02.000 WAIT S12    38  (TDP.PUB.SYS) text myfile
 C152 0:01.030 READY S12     67  (FCOPY.PUB.SYS)from=foo.pub.sys;to=ba
 r;new

To display a summary of information for all non-system processes in the current job/session, enter:

  :SHOWPROC

To display a summary of information for PIN 42, enter:

  :SHOWPROC #p42

To display a summary of information for PIN 42 and all of its descendants, enter:

  :SHOWPROC #p42; tree

To display the detail information for PIN 42, enter:

  :SHOWPROC #p42; format= detail

To display a summary of information for all processes (requires SM capability), enter:

  :SHOWPROC 1 ;system ;tree

To display a summary of information for all non-system processes that are jobs (requires SM or OP capability), enter:

  :SHOWPROC job=@j; anyuser

To display a summary of information for PINs 150, 247, and 211, enter:

  :SHOWPROC (150,#p247,211)

To display a summary of information for all non-system processes logged on as MGR.PAYROLL (requires SM or OP capability), enter:

  :SHOWPROC job=mgr.payroll

To display a summary of information for all non-system processes belonging to Job 2 or logged on as ME.AP (requires SM or OP capability), enter:

  :SHOWPROC job=(#j2,me.ap)

To display the detail information for all non-system processes in the current job/session, enter:

  :SHOWPROC detail

To display the detail information for all non-system processes on the system (requires SM or OP capability), enter:

  :SHOWPROC job=@; format= detail

The process scheduling and subqueue information appears in two major columns: DORMANT and RUNNING. RUNNING processes are those that currently require the CPU in order to continue, or that will require it in the immediate future. CPU time is automatically allocated to the highest priority process that is ready to run. DORMANT processes are those waiting on longer-term events.

On occasion, a process appears in more than one column, indicating that it was changing state when you executed SHOWQ.

As the default, SHOWQ lists dormant and running processes and the scheduling characteristics of the CS, DS, and ES subqueues. However, the ACTIVE and STATUS options permit you to filter the SHOWQ output which, on large systems, may display hundreds of live processes.

Use the ACTIVE option to display running processes and the scheduling characteristics of the CS, DS, and ES scheduling subqueues. Use the STATUS option to display just the scheduling characteristics of the CS, DS, and ES subqueues. (Note that the ACTIVE output appears when both options are specified, since status information is a subset of the active information.)

Below is an example of the two-column output produced by the SHOWQ command. The symbols that may appear in such a listing are explained in the remainder of the discussion.

  DORMANT       RUNNING
  Q PIN JOBNUM   Q PIN JOBNUM
 
  A 1        C M163 #S263
  B 2        C U215 #S256
  B 3
  A 4
  D U29 #J30
  C M37 #S234
  C M55 #S248

Each entry in the three columns displays the following information for a single process; the meaning is explained below.

  A    the queue attribute of the process is AS
 
  B    the queue attribute of the process is BS
 
  C    the queue attribute of the process is CS
 
  D    the queue attribute of the process is DS
 
  E    the queue attribute of the process is ES
 
  M    this is a job or session main process
 
  U    this is a user process
 
  pin   process identification number, a decimal
 
  J nnn  job number: a process executing in a batch job
 
  S nnn  session number: a process executing from a session

The process identification number (pin) may appear with or without an M or U label. Processes without an M or U label are system processes.

In addition, SHOWQ prints the scheduling characteristics currently in effect. In the example below, QUEUE is the scheduling subqueue and BASE, LIMIT, MIN QUANTUM, MAX QUANTUM, BOOST and TIMESLICE are scheduling values set by the TUNE command. MIN and MAX quantums are bounds for the quantums and ACTUAL quantum is the current quantum value.

            QUANTUM
  QUEUE BASE LIMIT MIN  MAX  ACTUAL BOOST TIMESLICE
  -  - -  -   - -
  CQ   152  200   1  2000  200   DECAY 200
  DQ   202  238  2000 2000  2000  OSC  200
  EQ   240  253  2000 2000  2000  DECAY 200

You may issue the SHOWQ command from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command. SHOWQ requires System Supervisor (OP) capability.

	NOTE: The MPE/iX Scheduler now supports the workgroup concept. However, backward compatibility is maintained through five default workgroups created by the system. The scheduling characteristics of the CS_Default, DS_Default, and ES_Default workgroups mimic those of the CS, DS, and ES scheduling subqueues. In fact, the information displayed for the CS, DS, and ES scheduling subqueues is the same information as that for the default workgroups. Please refer to the NEWWG and SHOWWG commands for more detail. Since SHOWQ displays limited information regarding workgroup processes, Workload Manager users should use the SHOWWG and SHOWPROC commands rather than SHOWQ. Non-Workload Manager users may choose to use these commands if they prefer the format for viewing the default workgroups.

To display the active processes and the current scheduling subqueue characteristics, enter:

  :SHOWQ;ACTIVE
 
  DORMANT       RUNNING
  Q PIN JOBNUM   Q PIN JOBNUM
 
           C M163 #S263
           C U215 #S256
 
 
            QUANTUM
  QUEUE BASE LIMIT MIN  MAX  ACTUAL BOOST TIMESLICE
  -  - -  -   - -
  CQ  152  200  1   2000  200   DECAY 200
  DQ  202  238  2000 2000  2000  OSC  200
  EQ  240  253  2000 2000  2000  DECAY 200

None.

Prints current time and date, as indicated by system clock.

This command may be issued from a session, job, program, or in BREAK. Pressing Break has no effect on this command.

To display the time and date, enter:

  SHOWTIME
  MON, JUL 24, 1987, 8:47 AM