LOG—write a message to the log data set

The LOG service causes a message to be written to the ISPF log data set.

The log data set, if allocated, is normally processed when you exit ISPF. A LOG command is available to allow you to process the log data set without exiting ISPF.

Command invocation format


>>-ISPEXEC--LOG--MSG(message-id)-------------------------------><

Call invocation format


>>-CALL--ISPEXEC--(buf-len,--buffer);--------------------------><


>>-CALL--ISPLINK--('LOGbbbbb',--message-id);-------------------><

Parameters

message-id: Specifies the identification of the message that is to be retrieved from the message library and written to the log.
buf-len: Specifies a fullword fixed binary integer containing the length of "buffer".
buffer: Specifies a buffer containing the name of the service and its parameters in the same form as they would appear in an ISPEXEC call for a command procedure.

Return codes

These return codes are possible:

0: Normal completion.
12: The message-id contains invalid syntax or was not found.
20: Severe error.

Example 1

In a CLIST, dialog variable TERMSG contains a message-id. Write this message in the ISPF log file.

ISPEXEC LOG MSG(&TERMSG )

Example 2

In a PL/I program, program variable TERMSG contains a message-id. The variable TERMSG has been made accessible to ISPF by a previous VDEFINE operation. Write this message in the ISPF log file. Set the program variable BUFFER to contain:

LOG MSG(&TERMSG)

Set program variable BUFLEN to the length of the variable BUFFER. Issue the command:

CALL ISPEXEC (BUFLEN, BUFFER);

or alternately

CALL ISPLINK ('LOG     ',TERMSG);

Example 3

Write message ABCX013 in the ISPF log file.

ISPEXEC LOG MSG(ABCX013)

Set the program variable BUFFER to contain:

LOG MSG(ABCX013)

Set program variable BUFLEN to the length of the variable BUFFER. Issue the command:

CALL ISPEXEC (BUFLEN, BUFFER);

or alternately

CALL ISPLINK ('LOG     ','ABCX013 ');