Converting from using the broadcast data set to user logs

To implement the use of user logs, first copy sample member IKJTSO00 from SYS1.SAMPLIB to SYS1.PARMLIB, if you have not already done so. You can create alternative members using the IKJTSOxx naming convention. In IKJTSOxx, modify the SEND PARMLIB parameter as follows:

LOGNAME: user log data set name
CHKBROD: ON

Note:

After you convert from using the broadcast data set to user logs, the return codes from the SEND command are different. For information about these return codes, see .
If your installation is implementing the use of user logs with security protection, see also Security protected user logs.

With these values, the following SEND and LISTBC processing occurs:

If a target user has not yet issued the LISTBC command or logged on and specified MAIL, and SEND needs to store a message for the user, the user's user log has not yet been allocated. Therefore, SEND stores the message in the broadcast data set.
When the target user either issues the LISTBC command or logs on and specifies MAIL, LISTBC determines that the user log has not been allocated. The LISTBC command processor allocates the user log. The user log data set name depends on the MSGPROTECT operand setting.
For more information about MSGPROTECT, see .

LISTBC allocates both sequential data sets and members of a PDS with the following data set attributes:
LRECL

150

BLKSIZE

1500

Primary tracks

1

Secondary tracks

2

Note: If MSGPROTECT is set to ON, see the data set attributes shown in Security protected user logs.

For members of a PDS, LISTBC uses a value of 20 for the number of directory blocks.
LISTBC then checks the broadcast data set for any messages for the user because it has just created the user log data set.
Note: If you modify the USEBROD operand to OFF, messages are not stored in the broadcast data set.
The next time SEND needs to store a message for the target user, the user log data set exists. SEND stores the message in the user log.

After a period of time, you can decide to no longer check the broadcast data set for stored messages. At this point, your users' user logs should have been allocated and you can set CHKBROD to OFF. If you define new users to your system, have them either issue the LISTBC command or request MAIL when they first log on, to ensure a user log is created.

At this point, you can use the TSO SYNC command to clean up the broadcast data set if you want.

Note: This will delete all mails from the broadcast data set.

LISTBC allocates the user log with specific attributes. You may decide that the default attributes are unsuitable for some or all of your installation's users. You can use the LISTBC pre-allocate exit to allocate the user log data sets instead of having the LISTBC command processor allocate them. For more information about the pre-allocate exit, see Writing exits for the SEND, OPERATOR SEND, and LISTBC commands.