TURN

Output logging file

Component:	BS2000
Functional area:	Error logging
Domain:	not allocated
Privileges:	OPERATING
Privileges:	E

Function

This command enables the operator or an authorized user program to request an information dump from the current logging file (SYS.CONSLOG...).

The day, time, destination and source selection criteria allow the issuer of the command to match the message output to information requirements. After the TURN command has been issued, 5 messages are listed. Then the following message appears:

&tsn-akz.hhmmss % EXC0432 PROCESSING of /TURN TO BE CONTINUED? REPLY
                  (Y=YES;N=NO)?

The operator’s answer is in the form “tsn-jid:Y” or “tsn-jid:N”, where:

<tsn> <jid>

is the task sequence number of the job in the form 'nnnn'. is the job ID assigned when the command is entered. If you do not assign a job ID when entering the command, you do not have to give one for the response. The default job ID '000' can therefore be omitted for the response.

No more than three failures to answer correctly are allowed. A fourth incorrect answer causes the TURN command to be terminated.

Note

It is not possible to process several TURN commands at the same time. A second TURN command will be rejected with the following message:

EXC0431 PROCESSING OF AN EARLIER /TURN NOT YET COMPLETED. RETRY COMMAND LATER

The output messages of the file SYS.CONSLOG... are not logged. 

Format

TURN                                                                                                                                                          

DAY = *TODAY / <integer 1..31>

,TIME = *LOG-START / <integer 0..235959>

,SRC = *NO / list-poss(2000): <alphanum-name 2..4>

,DEST = *NO / list-poss(2000): <alphanum-name 1..4>

,DESTALL = *NO / list-poss(2000): <alphanum-name 2..4>

Operands

DAY=
Outputs messages recorded in the current log file on a specific day.

DAY = *TODAY
Outputs the messages for the current day of the system session.

DAY = <integer 1..31>
Day of the month. The day specified must have been reached within the log file.

TIME=
Outputs messages logged from a specific time onwards.
If the TIME operand is specified together with the DAY operand, the messages logged on the specified day after the specified time are output.

TIME = *LOG-START
Outputs messages from the start of the current log file or of the specified day onwards.

TIME = <integer 0..235959>
Time (hhmmss) within the current system session as of which the logged messages are to be output (hh = hour, mm = minute, ss = second).

SRC=
Selection of information (commands, messages and responses which have been input) according to the sender. The sender can be an operator terminal (console), a DCAM application or a task.

SRC= *NO
All the messages sent from the operator terminal (console) or authorized user program from which the TURN command originated are to be output.

SRC = list-poss(2000): <alphanum-name 2..4>
Selection can be based on:

• mnemonic device name (2 characters) of the operator terminal (console). The messages sent from this console are to be output.

• authorization name (4 characters) of a DCAM application

• task sequence number (4 characters).
  Information sent by this task is to be output.

DEST=
Selection of information (commands, messages and responses which have been input) according to the receiver. The receiver can be an operator terminal (console) or an authorized user program.

DEST= *NO
All the messages received by the operator terminal (console) or authorized user program from which the TURN command originated are to be listed.

DEST = list-poss(2000): <alphanum-name 1..4>
All messages directed to the specified receiver are to be listed: The following values are possible:

• the mnemonic device name (2 characters) of a physical operator terminal (console)

• a routing code (1 character)

• the authorization name (4 characters) of an authorized user program

DESTALL=
Selects messages with the routing codes assigned to the specified consoles. The receiver can be an operator terminal (console) or an authorized user program

Note

If the DESTALL operand has a value other than *NO, there are two different cases to consider:

1. DEST = *NO:
   Only the messages selected by DESTALL are displayed.

2. Otherwise:
   The complete set of messages selected by DEST and DESTALL is displayed.

DESTALL= *NO
All messages selected by the DEST operand are displayed.

DESTALL = list-poss(2000): <alphanum-name 1..4>
Selection is based on the complete set of routing codes of the specified consoles.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
2	0	EXC0428	Input abbreviated, processing continued
	1	CMD0202	Syntax error
	32	EXC0425	System deadlock
	64	EXC0254	CONSLOG not yet created
	64	EXC0433	Execution aborted
	130	EXC0424	Not enough memory
	130	EXC0431	Previous TURN not completed

Examples

1. A session commenced at 10 p.m.; at 6 a.m. the following command is issued:

   turn time=030000

   This causes all messages to be listed which occurred between 3 and 6 a.m.

2. A session commenced at 11:50:58, and at 11:52:25 the following command is issued:

   turn time=110000

   The specified time of 11 a.m. (when the session had not yet started) causes the command to terminate; no other messages are output.

3. A session commences at 8 p.m., and at 11 p.m. the next day the following command is issued:

   turn time=220000

   The messages which occurred after 10 p.m. on the second day are listed.