Using System Tasks

To use a system task, you must enter the task code defined for the system task. The way you do this is described in the following sections:
idmscu
To use a system task, you must enter the task code defined for the system task. The way you do this is described in the following sections:
2
2
How to Invoke System Tasks
You invoke a system task by entering the
task code
for the task. For example, SIGNON, BYE, and DCUF are all task codes for system tasks. You enter the task code for a system task while using DC/UCF, in response to the prompt issued by DC/UCF.
In the following example, user LRB signs on to DC/UCF SYSTEM55:
Vnnn ENTER NEXT TASK CODE:      CA IDMS release nn.n tape volser node nodename   signon lrb
Task codes defined at system generation
Task codes for system tasks are defined at system generation time and can vary from site to site. Users can invoke a system task only when they have execute authority for the security categories assigned to the task
and
all of the related programs.
For more information about the TASK and PROGRAM statements used to define system tasks, see the section.
Task Code Specification Rules
The following rules apply when entering system task codes in the TP-monitor command line:
  • One system task code can only be entered at a time.
  • The task code must be separated from command keywords (if any) by one or more blanks.
Keyword abbreviations
When a system task provides keywords, you can enter full or abbreviated keywords along with the system task's task code. For example, each of the following DCMT DISPLAY TASKS commands is valid:
dcmt    display ta dcmt d tasks dcmt  d ta
Valid abbreviations for command keywords are shown in the syntax diagrams for the individual commands. Capitalized letters in the syntax diagrams must be entered; lower case letters are optional.
How to Correct Typing Errors
If you make mistakes when entering a system task, DC/UCF redisplays keywords (if any) for the task, along with an error message. In the following example, you mistype the keyword "tasks" and enter
rasks
instead:
Vnnn ENTER NEXT TASK CODE:       CA IDMS release nn.n tape volser node nodename   
dcmt display rasks
After you press Enter, the incorrectly typed command is redisplayed and flagged as an error:
  DISPLAY RASKS           * ERROR IDMS DC260004 V55 INVALID SYNTAX TOKEN FOUND Vnnn ENTER NEXT TASK CODE:       CA IDMS release nn.n tape volser node nodename
You can correct your typing error in one of the following ways:
  • Enter the necessary characters in the redisplayed line, as shown below:
    dcmt
     DISPLAY 
    t
    ASKS              * ERROR IDMS DC260004 V55 INVALID SYNTAX TOKEN FOUND Vnnn ENTER NEXT TASK CODE:       CA IDMS release nn.n tape volser node nodename
  • Re-enter the command after the TP-monitor prompt, as shown below:
         DISPLAY rasks              * ERROR IDMS DC260004 V55 INVALID SYNTAX TOKEN FOUND Vnnn ENTER NEXT TASK CODE:       CA IDMS release nn.n tape volser node nodename   
    dcmt display tasks
How to Page Through Multiple-page Displays
Some system tasks display multiple pages of information. For example, a DCMT DISPLAY PROGRAMS command issued on a large production system can return several pages of information.
When one or more pages of information remain to be displayed, a message at the bottom of the screen displays the page number of the current page in the format PAGE
nnn
.
              PAGE 
nnn
 - NEXT PAGE:
At the NEXT PAGE prompt, enter a page number to skip to a specific page. The page can be before or after the current page.
Using control keys to page
You can page back and forth through multiple-page screens by using the following control keys:
  • Press Enter or PA1 (default) to page forward
  • Press PA2 to page backward
Exiting from a multiple-page screen
To exit from a multiple-page screen, you can do one of the following:
  • Press the Clear key
  • Enter a page number larger than the largest page number of the display (for example,
    9999
    )
How to Broadcast System Tasks
If the central version (CV) is a member of a data sharing group (DSG), system tasks DCMT, DCUF, and SEND can be told to also execute on other central versions that are members of the same DSG. This is called broadcasting. Broadcasting can be done to either all or a list of DSG members.
Syntax
►►─ 
task
 ─┬───────────────────┬─────────────────────────────────────────────►◄           └─ 
broadcast-parms
 ─┘
Expansion of broadcast-parms
►►─ Broadcast ──┬───────────────────────────┬───────────────────────────────►◄                 │     ┌─ separator ───┐     │                 └─ ( ─▼─ 
member-name
 ─┴─ ) ─┘
Parameters
  • broadcast-parms
    Specifies how to execute the task.
  • Broadcast
    Specifies to execute the specified task on one or more members of the data sharing group. If no list of members is specified, the task is executed on ALL members.
    • separator
      Separates multiple member names. Use a comma or at least one space.
    • member-name
      Identifies the data sharing member (or a list) on which to execute the specified task.
Usage
Authorization
The issuing user must have the authority to execute the command on all members of the group to which it is directed. If the proper authority is not held on a member, the command will not execute on that member, but it can execute on other members that hold the proper authority.
Output
The output from a broadcast command is segmented by member. All output from one member is displayed before that of another member. When broadcasting to all members, the output for the member on which the command is issued is displayed first. Other member's output is identified by a header indicating the name of the member.
Broadcastable task restrictions
Broadcastable tasks have the following restrictions:
  • DCMT
    All DCMT commands can be broadcast, except for the following commands:
    • DCMT ABORT
    • DCMT DISPLAY/VARY NUCLEUS
    • DCMT QUIESCE
    • DCMT SHUTDOWN
    • DCMT VARY DMCL
    • DCMT VARY ID
  • DCUF
    Only the DCUF SHOW USER command can be broadcast.
  • SEND
    All commands can be broadcast. Parameter prompting is not possible when broadcasting.
Example
DCMT B V SEGMENT EMPDEMO
DCMT B V SEGMENT EMPDEMO OFFLINE ---------- Area -----------   Lock    Lo-Page    Hi-Page #Ret  #Upd #Tret #Ntfy EMPDEMO.EMP-DEMO-REGION        Ofl      75001      75100    0     0     0     0  Stamp: 2002-11-17-09.55.31.875826  Pg grp: 0      NoShare  NoICVI  NoPerm EMPDEMO.INS-DEMO-REGION        Ofl      75101      75150    0     0     0     0  Stamp: 2002-11-17-09.55.31.956231  Pg grp: 0      NoShare  NoICVI  NoPerm EMPDEMO.ORG-DEMO-REGION        Ofl      75151      75200    0     0     0     0  Stamp: 2002-11-17-09.55.31.887739  Pg grp: 0      NoShare  NoICVI  NoPerm ===> Output from group member SYSTEM73 ---------- Area -----------   Lock    Lo-Page    Hi-Page #Ret  #Upd #Tret #Ntfy EMPDEMO.EMP-DEMO-REGION        Ofl      75001      75100    0     0     0     0  Stamp: 1001-08-07-14.58.14.855461  Pg grp: 0      NoShare  NoICVI  NoPerm EMPDEMO.INS-DEMO-REGION        Ofl      75101      75150    0     0     0     0  Stamp: 1001-08-07-14.58.14.896650  Pg grp: 0      NoShare  NoICVI  NoPerm EMPDEMO.ORG-DEMO-REGION        Ofl      75151      75200    0     0     0     0  Stamp: 1001-08-07-14.58.14.874287  Pg grp: 0      NoShare  NoICVI  NoPerm