INFORM - Display information about printers for a printer control LTERM

The tacpadm INFORM allows you to display information about printers and about the message queues assigned to any particular printer.

openUTM provides the following information about the printers assigned to the printer control LTERM:

• Name of the LTERM partner to which the printer is assigned

• Status of the printer, i.e. openUTM indicates whether the printer is currently connected to the application and whether or not the printer is disabled

• Confirmation mode, i.e. openUTM indicates whether the printer is set for automatic mode or confirmation mode

• Number of output jobs currently buffered in the queue of your selected printer, or the queue of the printer pool

• Number of time-driven output jobs currently buffered in the queue.

openUTM supplies the following information about the output jobs in the queue of a printer or a printer pool:

• Time at which the job was generated

• For time-driven jobs, the time as of which the job is to be processed

• Information about whether a positive or negative confirmation job is linked to the job.

The lists containing the information which openUTM returns can in some cases be very extensive. For this reason, the following options are provided:

• rerouting the output to a printer (OUT).

• restricting the output by specifying the job ID of the job with which the output list should start. The lists should be in ascending order of job ID. When you enter a job ID in CONT, the list starts with this job. No information is then provided about jobs whose job ID occurs earlier in the listing.

---

tacpadm     INFORM

           ,LIST= { PRINTERS | ACK }

           [ ,CID=cid1 ]

           [ ,CONT=cid2 ]

           [ ,OUT={ KDCDISP | ltermname1 } ]

           [ ,CTERM=ltermname ]

---

INFORM		Outputs a summary list of printers or output jobs.
CID=cid1		( control- ID )  Printer ID of the printer. If you do not enter cid then openUTM returns information about all printers and message queues assigned to the printer control LTERM.
LIST=		Indicates which information has been requested.
	PRINTERS	Information about printers
	ACK	Information about the output jobs in the printer queues which still have to be confirmed.
CONT=cid2		Controls the scope of the output. For cid2 you can enter the job ID of the printer as of which the list of information is to start. There is no point entering CONT= unless the output produced in response to an earlier INFORM call does not fit on one screen page. To continue output, you enter the printer ID of the last printer that handled the previous output when you enter the next call in cid2.
OUT=		Specifies where openUTM is to output the information.
	KDCDISP	openUTM outputs the information to the terminal on which the information was requested or passes the information to the client which requested the information.
	ltermname1	openUTM outputs the information to the printer. For ltermname1, enter the name of the LTERM partner to which the printer is assigned. Default: KDCDISP
CTERM=ltermname
		Printer control LTERM to which the printer cid1 belongs. For ltermname, enter the name of the printer control LTERM. If the command is not entered at the printer control LTERM of printer cid1, the user who enters the command must have administration privileges. Default:  Name of the LTERM partner at which the command is entered.

Result

For LIST=PRINTERS

 Control-id State   Connected Mode      LTERM-name  # of msg.: output delayed
 cid1       Y/N     Y/N       auto/ack  lterm1                 num1   num2

Key to terms:

Control-id

Printer ID of the printer

State

Indicates whether the printer is disabled (N) or not (Y)

Connected

Indicates whether the connection to the printer is established (Y) or not (N)

Mode

Indicates whether confirmation mode (ack) or automatic mode (auto) is selected

LTERM name

Name of the LTERM partner to which the printer is assigned

output

Number of output jobs currently buffered in the printer queue

delayed

Number of time-driven output jobs (DPUT job) currently buffered and waiting to be processed in the printer queue and whose start time has not yet been reached. 

For for LIST=ACK:

 Control-id   User-id  DPUT-id  Gen-time   Start-time   Pos/Neg chain msg
 cid1         user1    dput-id  time1      time2         p / n / p n 

Key to terms:

Control-id Printer ID of the printer

User-id

User ID or “*NONE“, if the user who generated the job has been deleted.

DPUT-id

Job ID of the asynchronous job

Gen-time

Time at which the asynchronous job was generated. Enter time in the form (ddd,hh,mm,ss), where ddd is the number of the day in the year, hh is the time in hours, mm the time in minutes and ss the time in seconds.

Start-time

This is output only for time-driven jobs (DPUT jobs).
Start-time is the earliest time as of which the job can be processed. The output format for time is the same as for Gen-time.

Pos/Neg chain msg.

Specifies whether a positive or negative confirmation job exists. The display field contains a “p” if a positive confirmation job exists and an “n” if a negative confirmation job exists. “p n” indicates that both a positive and a negative confirmation job exist.