Tasking Command Equivalents

MARC and the ODT allow you to enter almost all of the same system commands for process initiation, monitoring, and control. In addition, CANDE allows you to enter process control commands that correspond closely to system commands.

The system commands available in MARC for process control are spelled the same as those available at an ODT, and have the same functionality, with the following exceptions:

  • Security

    If the Transaction Server security category COMMANDCAPABLE is defined, then only users defined as COMMANDCAPABLE can submit system commands in MARC. Further, some commands are available only to users with SYSTEMUSER, SYSADMIN, or privileged status. Some other commands are filtered. That is, they are limited to monitoring and controlling processes with the same usercode as the MARC session. For further information about COMMANDCAPABLE, SYSTEMUSER, SYSADMIN, and privileged status, refer to the Security Operations Guide.

  • Spelling

    The MSG (Display Messages) system command is spelled SMSG in MARC.

CANDE process control commands differ from the corresponding system commands in the following ways:

  • Spelling

    The CANDE process control commands each begin with a single question mark (?). In addition, the following spelling differences exist:

    • ?JA corresponds to the J (Job and Task Structure) system command.

    • ?CS corresponds to the mix number system command, which is formally known as the COMPILE STATUS (Information for Compiler Task) command. Note that the ?CS command in CANDE is not related to the CS (Change Supervisor) system command.

    • ?MXA corresponds to the MX (Mix Entries) system command. ?MXA can be abbreviated as ?MX or ?M.

  • Implicit mix numbers

    For commands that apply to a dependent process initiated directly from the CANDE session, you can omit the mix number from the command. For example, instead of entering ?1234 Y, you can enter simply ?Y.

  • Security

    In general, the CANDE process control commands can monitor or control only processes running with the same usercode as the CANDE session. If you attempt to apply a CANDE process control command to a process running with a different usercode, CANDE displays the message “INVALID NUMBER.” However, CANDE makes one exception to this restriction. If you initiate a process in a CANDE session, and that process later changes its own usercode, CANDE still enables you to apply process control commands to that process.

  • Mix display options

    The CANDE mix display commands (?C, ?JA, ?LIBS, and ?MXA) do not provide the following options of the equivalent system commands: ALL, MCSNAME, NAME, QUEUE, and USER. However, the ALL option is implicitly set for all CANDE mix display commands. Furthermore, CANDE mix display commands do offer one feature that the corresponding system commands do not: the ability to specify a logical station number (LSN), which limits the display to processes originating from the specified station.

Interactive Tasking Functions shows the equivalent commands in these three interfaces and briefly states the function of each command. In the MARC column of Interactive Tasking Functions, the abbreviation (f) indicates commands that are filtered; (su) indicates commands that require SYSTEMUSER or SYSADMIN status. Commands are not filtered for users with SYSTEMUSER or SYSADMIN status. For complete descriptions of these commands, refer to the System Commands Reference, the Menu-Assisted Resource Control (MARC) Operations Guide, and the CANDE Operations Reference Manual. For a general introduction to process monitoring and control from an ODT, refer to the System Operations Guide.

In the following table, <mixno> indicates the mix number.

Note: The <mixno> syntax is formally known as the COMPILE STATUS (Information for Compiler Task) system command.

Table 1. Interactive Tasking Functions

Functional Area

ODT or Operations Center

MARC

CANDE

Specific Function

Initiating Processes

PRIMITIVE RUN

None

None

Initiate an object code file as an independent process.

??RUN (ODT only)

None

None

Initiate an object code file as an independent process.

RUN

RUN

RUN, UTILITY

Initiate an object code file as a dependent process.

<WFL statements>

WFL

WFL

Submit WFL statements.

START

START

START

Submit a WFL program stored in a file.

Managing Queued WFL Jobs

<mixno>DS

?<mixno> DS (f)

?<mixno> DS

Discontinue a queued WFL job.

FS

FS (su)

None

Force initiation of a queued WFL job.

MOVE

MOVE (su)

None

Change order of queued WFL jobs.

PF

PF (su)

None

Display FETCH message associated with a WFL job.

PQ

PQ (su)

None

Discontinue all the WFL jobs in a queue.

PR

PR (su)

None

Change the priority of a queued WFL job.

SQ

SQ (f)

?SQ

Display the WFL jobs in a queue.

STARTTIME

STARTTIME (f)

?<mixno> STARTTIME

Assign a start time to a queued WFL job.

Y

Y (f)

?<mixno> Y

Display information about a queued WFL job.

Monitoring the Mix

ADM (ODT only)

None

None

Periodically display system mix and other items.

C

COMND C (f)

?C

Display completed entries.

DBS

DBS (su)

None

Display database stacks.

J

J (f)

?JA

Display active mix entries, grouped into process families.

LIBS

LIBS (f)

?LIBS

Display library processes.

MSG

SMSG (f)

?MSG

Display process messages.

MX

MX (f)

?MXA

Display active, scheduled, and waiting mix entries.

S

S (su)

?S

Display scheduled mix entries.

W

W (f)

?W

Display waiting mix entries.

Displaying Process Status

Y

Y (f)

?Y

Display current status of a process.

<mixno>

<mixno>

?<mixno> or ?CS

Display the status of a compilation.

OT

OT (f)

?OT

Display contents of a selected word in the process stack.

Displaying Process Resource Usage

CU

CU (f)

?CU

Display current memory usage of a process.

TI

TI (f)

?TI

Display accumulated processor, I/O, presence bit, ready queue, and elapsed times for a process.

Communi-cating with a Process

HI

HI (f)

?HI

Cause process EXCEPTIONEVENT and optionally assign a TASKVALUE.

AX

AX (f)

?AX

Pass a string of text to a process.

IB

IB (su)

None

Display instruction block associated with a WFL job.

PF

PF (su)

None

Print a FETCH message associated with a WFL job.

SW

SW (f)

?SW

Modify the SW1 through SW8 task attributes of a process.

Modifying an Active Process 

DS

DS (f)

?DS

Abnormally terminate execution of a process.

DUMP (DP on Operations Center toolbar)

DUMP

?DUMP

Initiate a program dump.

FS

FS (su)

None

Force initiation of a scheduled process.

LP

LP (f)

None

Protect a process from DS or QT commands.

PR

PR (su)

None

Change the priority of a process.

ST

ST (f)

?ST

Suspend execution of a process.

Responding to Suspended Processes

AX

AX (f)

?AX

Pass a string of text to a process.

BADFILE (BF on Operations Center toolbar)

BADFILE (f)

None

Continue to copy a file from tape to disk when tape errors occur.

DS

DS (f)

?DS

Discontinue a process.

FA

FA (f)

?FA

Modify file attributes used by a process.

FM

FM (su)

None

Change the printer form used by a process.

Responding to Suspended Processes (cont.)

FR

FR (f)

?FR

Specify that a tape reel is the last of a multireel set.

IL

IL (su)

None

Change the physical unit used for an input file.

NF

NF (f)

?NF

Return an open error to a process opening a file that is not an optional file.

NOTOK

NOTOK (f)

?NOTOK

Prevent the process from attempting a given action, but do not discontinue the process.

OF

OF (f)

?OF

Indicate an optional file is not present.

Responding to Suspended Processes (cont.)

OK

OK (f)

?OK

Cause a suspended process to attempt to resume processing.

OU

OU (su)

None

Change the physical unit used for an output file.

RM

RM (f)

?RM

Remove a file specified in a DUPLICATE FILE message.

UL

UL (su)

None

Assign an unlabeled tape file to a particular process.

Saving and Restarting Processes

BR

BR (su)

None

Display checkpoint eligibility or initiate a checkpoint.

OK

OK (f)

?OK

Allow automatic restart of a process.

DS

DS (f)

?DS

Deny automatic restart of a process.

RERUN

WFL RERUN

WFL RERUN

Initiate manual restart of a process.

RESTART

RESTART

None

Terminate and restart a WFL job.