1.3.6 "OS/390 V2R9.0 TSO/E User's Guide" via IBM BookManager BookServer

1.3.6 Storing Transmitted Data in a Log

A LOG data set is a journal of all TRANSMIT and RECEIVE activity. It keeps a record of:

What you transmitted
To whom you transmitted
When you transmitted
When what you transmitted was received (acknowledgment)
What you received
From whom you received
When you received

    ___ Example of a LOG data set __________________________________________  
   |   TRANSMIT         ** MESSAGE **              16 SEP 1987 10:26:16     | 
   |     TO: TOM        NODEID   TJONES  Tom Jones                          | 
   |   This is the text of a message that was                               | 
   |   transmitted                                                          | 
   |   ---------------------------------------------------------------------| 
   |   RECEIVE          ** ACKNOWLEDGMENT **       16 SEP 1987 10:34:06     | 
   |    FROM: TOM       NODEID  TJONES Tom Jones   16 SEP 1987 10:34:06     | 
   |      STORED        ** MESSAGE **              16 SEP 1987 10:26:16     | 
   |   ---------------------------------------------------------------------| 
   |   RECEIVE          A.SEQ.DATA                 17 SEP 1987 11:34:06     | 
   |    FROM: TOM       NODEID JONES Tom Jones     17 SEP 1987 11:30:10     | 
   |   This is the text of a message that was                               | 
   |   received along with a data set (SEQ.DATA)                            | 
   |       DSN:  YOURID.SEQ.DATA                                            | 
   |                                                                        | 
   |________________________________________________________________________|

The three entries in the above LOG data set show:

A transmitted message
Acknowledgment that a message you sent was received
A message received along with a data set

You may have several LOG data sets or just one. The default data set name is usually PREFIX.LOG.MISC but you can specify another name with the :LOGSEL and :LOGNAME tags in your Names data set. The :LOGSEL tag changes the second data set qualifier and the :LOGNAME tag changes the third data set qualifier. For more information about these tags see "Using Nicknames and the Names Data Set" in topic 1.3.4.

Another way to direct information to a specific log when sending information is with the LOGNAME operand of the TRANSMIT command. The LOGNAME operand changes the third data set qualifier. For more information about this operand, see OS/390 TSO/E Command Reference.

In addition, you can specify a log name with the LOGDATASET (or LOGDSNAME) operand on either or both of the RECEIVE and TRANSMIT commands. If the log data set does not exist, a sequential data set is created. If the log data set already exists and it is not sequential, you see an error message. This log name operand allows you to keep a log of transmissions.

If your installation uses security labels and security checking, the security label you are logged on at is associated with the transmitted data.

    ___ Example ____________________________________________________________  
   | To receive records of transmitted data to a log data set named         | 
   | PREFIX.MY.TRASH, enter:                                                | 
   |                                                                        | 
   |   RECEIVE LOGDATASET(my.trash)                                         | 
   |                                                                        | 
   |________________________________________________________________________|

When you specify more than one log data set, certain operands override others. The possibilities are as follows beginning with the most general. Each successive possibility overrides the previous one.

No operands - Information goes to PREFIX.LOG.MISC (or whatever default log data set your installation has set up.)
:LOGSEL and :LOGNAME tags in the control section of your Names data set - Information to and from addressees in the Names data set goes to the specified log data set name whose second and third qualifiers override LOG.MISC.
:LOGNAME tag in the nickname section of your Names data set - Information to and from a particular addressee in the Names data set goes to the specified log data set name whose third qualifier overrides both the 'MISC' in LOG.MISC and the third qualifier specified with the :LOGNAME tag in the control section of your Names data set.
LOGNAME operand of the TRANSMIT command - Information sent to a particular person is recorded in a log data set whose third qualifier is specified with the LOGNAME operand.
LOGDATASET (or LOGDSNAME) operand of the RECEIVE command - Information received is recorded in the log data set specified by the LOGDATASET operand.

The LOG/NOLOG tags and operands of the TRANSMIT command have a similar precedence. When the tags are used in the control section of your Names data set, they can be overridden when they are used with a specific nickname. The LOG/NOLOG operand of the TRANSMIT command overrides all previous specifications.

For more information about these operands, see OS/390 TSO/E Command Reference.

Return to library: [ OS/390 | TPF | VM | VSE | IBM Hardware | S/390 Redbooks | RS/6000 SP ]

Glossary - IBM Dictionary of Computing

How to: [ Order publications | Contact OS/390 ]

1.3.6 Storing Transmitted Data in a Log

IBM BookManager® BookServer Copyright 1989, 1999 IBM Corporation. All rights reserved.