|
With a mouseclick you get a describtion of the screen item.
General Remarks about Action Codes
Action Codes are usually a one or two letter abbreviation which is entered in the Action field of the task list alongside the task on which the required operation is to be performed. Normally, the operations specified by Action Codes will be performed when the mask is transmitted by pressing the ENTER key.
The Action Code X (execute Variable Action) is a special case. The specified Actions are first prepared in a table. The execution of these actions for the individual tasks will only be performed when the end of the list has been reached, or when the user explicitly requests it by entering a command A (execute Action). The A command has the advantage that, when in a long list, the user does not need to page right to the end before causing the Actions to be performed.
Note:
A comparison between Action Codes and Variable Actions can be found on page .
Display Help System for Action Codes
? Help System (Display a list of available Action Codes).
+P | + The window will be advanced by the specified number of lines.
-P The line in the list will be made the last line in the list.
- Remove a line from the list. From now on, the line will not be displayed. Variable Actions specified as ON& ... will not be executed for elements removed with '-'. TAS uses this Action Code internally to remove entries from the list that have been cancelled with the CAN Action Code.
The YANK command can be used to reverse the removal of these items.
Answer an Open Console Message
. [xxxx] Answer the specified Console message with tsn. or tsn.xxxx . The TSN of the task will be supplied by CFS.
This Action Code can only be used with a task list created with the OMSG User Option. For further information, see page .
A one to four digit alphanumeric string can be specified for xxxx.
Display the Full Text of a Console Message
FM Full Message. The Console message will be displayed in its full, unabridged form in Line Mode.
This Action Code can only be used with a task list created with the OMSG User Option. For further information, see page .
Symbolic Display of Task-specific System Tables
% [tab] The %tab Action Code enables TSN-specific system tables to be displayed. The following values can be specified for tab:
%TCB Task Control Block
%JCB Job Control Block
%JTBP Job To Be Processed Block
The %TCB Action code will cause a screen formatted as follows to be displayed:
With a mouseclick you get a describtion of the screen item.
For a description of the available commands and marker column entries for the SHOW mask, see page (SHOW command).
If the Action Code is given as % , i.e. without tab, a general mask requesting the parameters will be displayed. The format of this mask is described on page .
%act The user-defined processing represented by the mnemonic act will be executed.
%? A summary of all the mnemonic codes stored in the primary and secondary USERACT files will be displayed. Entries from the secondary (central) USERACT file will be identified with a '*'. For further information, see the section below: "Hierarchy of the USERACT Files".
The assignment of the mnemonic %act to the required user-defined process is achieved via the CFS.USERACT file. The structure of this file is described below.
CFS.USERACT file for user-defined Action Codes
CFS administrators and users can utilise the CFS.USERACT file to store alphanumeric mnemonic codes (%act) and their associated processes. Each %-Action Code can represent a single BS2000 DO procedure, a CFS procedure, or a command.
The CFS.USERACT file is a normal SAM file, created with EDT, with 3 different record types:
- Comment records can be inserted anywhere, and are characterised by an asterisk ('*') in column 1.
- Header records have the string '$%TAS%' begining in column 1. A command string follows from column 7, which can take one of the following forms:
- A BS2000 command, in the form /cmd.
- A BS2000 DO procedure to be started under control of the Job Report System in Enter mode, in the form E procedure.
- A TAS command, in the same form as it would be in the TAS command field, e.g. APPL.
- A command to be executed by CFS (e.g. starting a CFS procedure) must be prefixed with 'CFS'.
Example: CFSDO procedure
Every command can also be enhanced with parameters from the task list, which are represented by abbreviations (see below).
The command can span one or more continuation lines by entering a hyphen ('-') as the last character in the line. Continuation lines begin with '$' followed by one or more blanks and then the remainder of the text.
Additional information relating to the data object marked with the Action Code can be passed to the command to be executed by means of abbreviations in the form !xyz. Any entry from the title line of the task list can be inserted for xyz. Examples:
!TSN TSN of the task marked with the User Action Code.
!USER-ID Userid under which the task runs.
!JOBNAME Job name of the task.
A mnemonic code record (%act) follows a header record.
- Mnemonic cCode records begin in column 1 with an alphabetic character. The fields have the following format (see also example below):
Column 1-4 Variable portion act of the Action Code %act (act: alphanumeric, left justified, first character must be a letter). act may not contain the following strings: TCB, TET, JCB, JTBP
Column 11-80 Free text for description of the Action Code %act and the associated commands, or blanks. The full list of descriptions can be displayed on screen by entering the Action Code %?.
Assignment algorithm: %act <--> command:
A search will be made for the mnemonic code act in the primary USERACT file. The order in which the search for the primary USERACT file proceeds is further described in the section below, "Hierarchy of the USERACT Files", point 1) to 3).
If the mnemonic code act is not found in the primary USERACT file, the search will continue in the secondary USERACT file, $user-id.CFS.USERACT (see below, point 4) ).
If act begins with a number, this is interpreted as a Connection number, and the rest of the string as the mnemonic code. The BS2000 DO procedure associated with this mnemonic code will be passed to the specified connection for execution as follows:
/DO procedure
If a record with the specified description is found, the previous header record ($...) and the command to be executed will be identified. Any abbreviations representing parameters contained in the header record, such as !TSN, !USER-ID, will be substituted with the actual values from the marked data objects.
The Action Code %? can be used to display a list of all mnemonic codes and their respective commands.
Hierarchy of the USERACT Files
The following heirarchy determines which USERACT file is to be used by CFS:
1) Has a File command with LINK=USERACT (/FILE ...,LINK=USERACT) been issued?
2) If no TFT entry with the name USERACT exists, then the job name used in the LOGON command (/.name LOGON ...) will be identified, and used as a suufix for a file named 'CFS.USERACT.' .
3) If no job name was specified in the LOGON command, or if the file CFS.USERACT.name does not exist, a check will be made for a file named CFS.USERACT under the current userid.
4) If none of the above files exist, CFS will finally search for a file called $user-id.CFS.USERACT. $user-id is the userid under which CFS is stored.
AC The Allow Cancel Action Code resets that bit in the TCB of the task which prevents the task from being cancelled. AC thus reverses the effect of the FC Action Code (Forbid Cancel).
CAN [C|D|N|K] Cancel the Task.
C Appending C will issue a Cancel command for a Calendar job ( CANCEL-JOB *TSN(tsn), STEPS=*ALL-CALENDAR-REPETITIONS ).
D Appending D will issue the command CAN tsn,DUMP.
N Appending N will issue the command CAN tsn,NOSPOOL.
K Appending K will issue the command CAN tsn,KILL. Following this command, the message 'SYSTEMDUMP DESIRED FOR TSN xxx' will appear on the console, which must be answered before the Cancel, Kill command takes effect.
Display all Files belonging to the Task's Userid
CFS[J] A branch will be made back to CFS. An NP;user-id command will br executed which will select all files belonging to the userid under which the task is logged on. Appending J will cause all Job variables to be selected instead of files.
Context: Display the PCB (Stack) List of the Tasks
CX All PCB's (Stacks) of the tasks will be displayed in a mask with the following format:
With a mouseclick you get a describtion of the screen item.
All commands which can be entered from the command field of the Task list are also valid here.
Entering the Action Code D alongside any Stack entry will invoke the Display mask for that entry. The Display mask has the following format:
Display Format for a P1 Stack (PCB)
All commands which can be entered from the command field of the Task list may be entered here. Additionally, the command M (Modify) can be issued, enabling the contents of the registers of the Stack displayed to be modified.
Display format for a P2 Stack (PCB)
Display: Display Task Information
D A summary of the most important information regarding the task will be displayed. A mask with the following format will be displayed for Dialog or Enter tasks:
With a mouseclick you get a describtion of the screen item.
For a description of the individual fields, see page .
All commands which can be entered from the command field of the Task list can be entered here. Additionally, the following commands may be specified:
SETSW ON|OFF=(...)
The task switch can be modified with this command. The SETSW command must be entered without the preceding slash symbol ('/').
NT Next Task. This will cause the next task marked with the Action Code D to be displayed.
ATL [INT=n] Automatic Task List. This command results in a periodic update of the screen after n seconds (Standard = 30 secs.).
Subsystems activated by a Task
DSSM All subsystems activated by the task will be displayed in a list.
For further information, see the DSSM command on page .
FC The Forbid Cancel Action Code sets a bit in the TCB of the task which prevents that task being cancelled. This bit can be reset by executing the AC Action Code.
Display Module Load List for a Task
L The name of the loaded program phase (CSECT) of the task, as well as any modules loaded dynamically will be displayed in a mask with the following format:
With a mouseclick you get a describtion of the screen item.
All commands which can be entered from the command field of the Task list can be entered here.
Entering the Action Code D alongside a module will cause the Display mask to appear, in which the contents of the module will be displayed. To display areas of memory not occupied by a loaded module (e.g. REQM areas), use the DISP command.
Example: DISP 5F000,T=DSY. For a full description of the DISP command, see page .
MEM This Action Code will display the value of the utilised Class 3/4/5/6 memory (as the number of 4k pages). To retrieve the information originally occupying this column, enter the Action Code U (Update). The MEM Action Code provides the same information as the SIZE4 User Option (see page ).
Display the Name Entries of the Task
N [class] All the entries in the Name Manager belonging to this tasks will be displayed.
class Only the Name entries belonging to the specified class will be displayed for the task.
Possible values for class are, for example, BCAM, CONT, DCAM, DSP, EVNT, POOL, UTM. For a full description of all the possible classes, see page (User Option NAME). The Name list has the following format:
With a mouseclick you get a describtion of the screen item.
All commands valid in the task list may also be entered in the command field of this mask.
D The Action Code D (Display) will display the following information, depending on the class:
Class=POOL/CONT:
Display the Display mask (see page ). The memory area occupied by the Pool or the Contingency Routine will be displayed.
Class=EVNT/SERI:
Display the Bourse Creator and Bourse Holder, as well as the Admission Requests for the different chambers of the Bourse.
Class=UTM:
Summary of the current status of the UTM application. For a full description, see the chapter entitled "UTM Information", on page .
CON The Action Code CON (Connections) will display the application partners of the entries in the Names List which belong to the classes BCAM/DCAM/UTM. For further information, see page .
CLS [x] A BCLOSE command will be issued for the application via a Console connection opened from within CFS. This connection to $CONSOLE is not necessary from OSD V2.
x This value corresponds to the Wait parameter of the BCLOSE command.
N W=N
Y W=Y
Note:
To display a system global list of all Names used in the system, the NAME command can be used. All BCAM, DCAM, EVNT, POOL, SERI and UTM Names can be displayed by using the series of identically-named commands.
Display Files opened by a Task
OPN[L|nn] The files opened by the task will be displayed. This is achieved with the CFS User Option OPENIOESECPR,TSN=tsn or
OPENIOESECPR,TSN=tsn,LINK (Action Code OPNL (Open with Link names)) or
OPENIOESECPR,TSN=tsn,D-IO,RW,INT=nn (OPNnn, Open with utilised IO's during the interval of nn seconds).
After the Action Code has been executed, a CFS file list will be displayed containing all the files which have been opened by that task. The TAS command can be entered to return to the last screen which had previously been displayed. The OPN[L] Action Code can only be specified for a single task.
The Action Code TFT can be used instead of OPN.
Display the Monitor Job variables used by the task
ONEV All Monitor Job variables currently being used by this task will be displayed, i.e. those Job variables for which the task has issued an ONEVT command. These tasks can be selected in CFS with the ONEVT TSN=tsn User Option. After entering the Action Code a CFS file list will be created containing the Job variables. Entering the CFS Action Code OPN next to any of the displayed Job variables will cause all TSN's accessing this Job variable to be selected. Executing a TAS command will exit CFS and return to the last TAS screen to have been displayed.
Pn[E] A /PRIORITY tsn,n [,EXP] command will be executed for the indicated task. Possible values for the priority n are: 40 < n <=255.
PE The Action Code PE will execute a /PRIORITY tsn,EXP command for the task.
List all Devices used by a Task
PDT All devices used by a task will be listed.
For further information, see the PDT command on page .
S A /STA tsn command will be executed for the specified task. The Action Code STA can be used instead of S.
Start Device Command for Printer
SD The following BS2000 command will be executed for the print task indicated (the Device name appears in the "STATION" column and the FORM parameter in the "PROC" column): /SD DEV=device,FORM=form
SDSTD The following BS2000 command will be executed for the print task indicated by the Action Code: /SD DEV=device
SDN The following BS2000 command will be executed for the print task indicated by the Action Code: /SD DEV=device,USE=NO
SDNR The following BS2000 command will be executed for the print task indicated by the Action Code:
/SD DEV=device,USE=NO
/SQ REL=(tsn)
SDNF The following BS2000 command will be executed for the print task indicated by the Action Code: /SD DEV=device,USE=NO,FORCE=YES
SDNFR The following BS2000 command will be executed for the print task indicated by the Action Code:
/SD DEV=device,USE=NO,FORCE=YES
/SQ REL=(tsn)
SQ The following BS2000 command will be executed for the print task indicated by the Action Code: /SQ REL=(tsn)
SQtyp The following BS2000 command will be executed for the print task indicated by the Action Code: /SQ REL=(tsn),TYPE=typ.
The following values can be entered for typ: B | n | -n
Amend CPU Time Limit for a Task
Tn The CPU time limit for this task is set to n CPU seconds. The Action Code T can only be applied to Dialog tasks (Job type 3) and active batch jobs (Job type 2).
T+n The current CPU time limit is increased by n seconds.
T-n The current CPU time limit is reduced by n seconds.
T0 The value n = 0 forces the task to exceed the CPU time limit.
TNTL The CPU time limit is set to NTL (No Time Limit).
T The user will be requested for the new value for the CPU time limit for the task. The following values are permitted:
n New value for the CPU time limit. Same effect as Action Code Tn (see above)
NTL New value is set to NTL (No Time Limit)
+n The CPU time limit is increased by n seconds. Same effect as T+n (see above)
-n The CPU time limit is reduced by n seconds. Same effect as T-n
Note:
The User Option MAXCPU (see page ) can be used to display the previous CPU time limit as well as the remaining CPU time.
Display Task File Table Entries
TFT[NL] The TFT entries for this task will be displayed. This is achieved by invoking the CFS User Option OPEN tsn,LINK (Action Code TFT), or OPEN tsn (Action Code TFTNL (No Link)). After executing the Action Code, a file list will be displayed in which all the files opened by the task, or assigned with a link name will be displayed. The TAS command can be used to return to the last screen to have been displayed in TAS. The TFT Action Code can only be issued for one task at a time.
The OPN Action Code can be used instead of TFT.
Update an Entry in the Task List
U Update Task List. The PRI, TYPE, CPUTIME etc. columns will be updated to reflect the current values.
Mark Entries to be processed by a Variable Action
X A Variable Action in the form ONX ... is marked for execution on the specified entries with an X. If the Variable Action is defined in the form ON& ... , then the Action Code X is superfluous, since the Variable Action will automatically be executed for all entries in the task list.
