$G D

Function

To display job information for a job at another node.

Syntax


>>-$G--D--+-N--nnnn-+--,'jobname'--+-,J--|--JOB--n-+------------>
          +-name----+              +-,S--|--STC--n-+   
          '-destid--'              '-,T--|--TSU--n-'   

>--,O=--+-LOCAL--|--ANYLOCAL-+---------------------------------><
        +-nodename-----------+   
        '-destid-------------'

Parameters

J|JOBn or S|STCn or T|TSUn

The job ID (batch job (Jn), started task (Sn), or time-sharing user (Tn)) assigned to the job by the originating node. If more than one job exists with the specified job name, and you want to display only one particular job, you must specify this parameter.

‘jobname'

The name of the job for which information is displayed. The name must appear as coded on the job statement and must be enclosed in apostrophes. If the job did not originate at the sending node (or have default print and/or punch output for the sending node), the destination node must have the sending node flagged as having network authority.

Nnnnn|name|destid

The destination node to which JES2 sends this command. You can specify this location by an alias for the name of a node. If you omit this operand, JES2 treats this as a global locate command and sends it to all reachable nodes in the network. Each node responds individually to the command.

Note: This command is rejected if the destination node is not currently connected to the network.

O=

The node on which the job originated. You must specify this parameter if the originating node is not the node at which this $G D command is entered. If you fail to identify the originating node, JES2 issues the $HASP693 message which indicates the job was not found. The valid specifications:

LOCAL|ANYLOCAL: Indicates that jobs are to be run at the local node.
Nnnnn|nodename: Indicates that jobs are to be run at the specified node(s). You can specify a node using a decimal node identifier from 1 to 32767 or an EBCDIC nodename.
destid: Indicates that jobs are to be run at the specified node(s). You can specify this location by an alias for the name of a node.

Note: This parameter requires that the destination node has the sending node flagged as having network authority.

Authority Required

This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

For the authority required at the destination node, see Displaying and controlling jobs at other nodes.

Processing Considerations

The information returned from the other node for display contains the same job information displayed in response to a $D J command.
The job number displayed is the number assigned to the job by its originating node.
The $T NODE,Auth= command sets the command authority of a specified node.

Scope

Network-wide. This command only needs to be issued from a single member; the command has an effect across the entire MAS.

Messages

The $HASP000 command indicates that the command has been accepted.

The message id of the message displaying the status of the job is dependent on the operating system on the node to which the command was issued. For example, a command issued to a JES2 system may display $HASP890, depending on the level of JES2 on the target system.

Examples

 1   $gdn2,'myjob'

  $HASP000 OK
  JOB00019 N2   M2 $HASP890 MYJOB   EXECUTING A PRIO  9 IBM2

JES2 sends a global display command record through the network to node 2. Node 2 returns to the sending node a display of job information for all jobs named MYJOB on node 2 that are owned by the sending node (that is, jobs originating at the sending node or jobs for which the sending node has network authority at node 2).

 2   $gd,'joba',j17,o=denver

  $HASP000 OK
  N2   M2 $HASP693 $GD JOBA   JOB NOT FOUND

Because a specific destination node was not specified, JES2 sends a global display command to every reachable node in the network. Each node responds with either a JOB NOT FOUND response or a display of job information for the job named JOBA that originated at the node named DENVER and had an original job number of 17. (Note that, unless the node entering the command is named DENVER, it must have network authority at the node where the job is currently located.)