WebAdmin allows you to administer asynchronous jobs which are buffered in the local message queues of a UTM application and awaiting processing. The entire functionality of the KDCS program interface DADM call is available in an easy-to-use form via the WebAdmin graphic user interface.
You can:
- Display information about asynchronous jobs that are buffered in a message queue (including any user information).
WebAdmin requests the user information with a maximum length of 1024 bytes from the UTM applications.
- Promote an asynchronous job within a message queue so that it is processed before all the other jobs in the queue.
- Delete an asynchronous job or all the jobs in the message queue.
- Display the messages of the asynchronous jobs for service-controlled queues
Service-controlled queues are temporary queues, Tac queues and User queues (see also Service-controlled queues in WebAdmin).
WebAdmin requests the messages with a maximum length of 1024 bytes from the UTM applications.
The following UTM objects may be attached to a message queue:
- Service-controlled queues
- Asynchronous Tacs
- Lterms
- Lpaps and Osi Lpaps
The properties dialog for these objects in the WebAdmin administration section contains the button 'Display Message Queue'. If you click this button, WebAdmin displays all the asynchronous jobs in the message queue for the object in a new object list, the message queue list. It should be noted that in UTM clusters, this button is only present in object properties dialogs that apply locally to the node and not in those that apply globally in the cluster.
The following items of information are output for each job:
Column | Meaning |
|---|---|
Job ID | The ID of the asynchronous job assigned by UTM. |
Position | Position number of the asynchronous job within the message queue. |
Job Submitter | UTM user who initiated the asynchronous job. |
Job Submitter Type | The Job Submitter of the asynchronous job can be a user, a LU6.1 session or a OSI-TP association. |
Generation Time | Time at which the job was submitted in the form "nnn / hh:mm:ss", where nn is the number of the day in the year (from 1 to 366) and hh:mm:ss is the time of day in hours, minutes and seconds (system time of the application computer). |
Start Time | In the case of time-controlled jobs (DPUTs), this is the desired start time in the form "nnn / hh:mm:ss" (system time of the application computer). |
Destination | Name of the message destination. |
Destination Type | Type of message destination. |
Positive Confirmation Job | Specifies whether there is a positive confirmation job for the asynchronous job. |
Negative Confirmation Job | Specifies whether there is a negative confirmation job for the asynchronous job. |
User Information State | Provides information concerning the status of the user information for the asynchronous job. The following outputs are possible: 'not requested': 'incomplete': 'complete': |
User Information | User information for the asynchronous job with a maximum length of 1024 bytes. The following outputs are possible: '<not requested>': '<none>': Other values: |
Message State | Provides information about the status of the message for an asynchronous job in a service-controlled queue. The following outputs are possible: 'not requested': 'incomplete': 'complete': |
Message | Message for asynchronous job in a service-controlled queue with a maximum length of 1024 bytes. The following outputs are possible: '<not requested>': Other values: |
Redelivery Counter | Counter indicating how often the message has already been delivered. Redelivery Counter is only displayed for service-controlled message queues provided that the message has already been read. |
Data Read at... | Time when the data of the asynchronous job was retrieved from the UTM application (system time of the WebAdmin computer). |
The following actions can be performed for the list of message queue entries:
- 'Request All User Info'
Retrieves the user information or the messages corresponding to the individual message queue entries from UTM.
- 'Delete All Jobs'
Deletes all the jobs in the message queue.
The following additional action can be performed for the list of message queue entries in a service-controlled queue:
- 'Request All Messages'
Retrieves the messages corresponding to the individual message queue entries from UTM.
The following additional action can be performed for the list of message queue entries in the dead letter queue:
- 'Move All Jobs'
Moves all the jobs in the dead letter queue to the corresponding original destination or to another destination.
Click on the job ID of a job in the list of message queue entries to display the job's property page. This property page contains buttons for performing the following actions:
- 'Prioritize Job'
This command is available if the job is not already at the head of the message queue (position 1). You use this action to tell openUTM to move the selected job to the front of the queue so that it is the next to be executed.
- 'Delete Job'
Deletes the job from the message queue.
- 'Move Job'
This command is only available for the dead letter queue.
Moves the job from the dead letter queue to the original destination or to another destination. You can specify the destination in the dialog box that is then displayed.
The destinations can be asynchronous Tacs or Tac queues with the exception of the Tacs "KDCDLETQ" and "KDCMSGTC". Also Lpaps or Osi-Lpaps can be selected. But the new destination must be of the same type as the original destination.
You can use the 'Printable' and 'Hexa Printable' radio buttons to define the way in which the user information or messages are displayed in a job's property dialog.