Stopping RJP console messages *FREE,con

Function

Use the *FREE command to stop output of all messages currently queued for a RJP console at the time the command is issued. All messages queued for the RJP console after the command is issued are displayed normally. If you omit the con parameter, the command applies to the RJP console from which you issue the command.

The *FREE command stops all output messages queued in storage for the workstation. Messages saved on the JES3 spool are not deleted.

Attention: Use this command with caution because it purges not only the messages issued by a single function (for example, the reply to an *INQUIRY,Q request), but all messages waiting to be displayed or printed (for example, sign-on, mount, and device error messages).

Syntax

>>---*FREE----+--------+---------------------------------------><
              '-,--con-'   

Equivalent MVS™ command

Control Q

Sends the messages that are currently queued to this MCS console to the log. See z/OS MVS System Commands for more information about the Control Q command.

Parameter

con

Specifies the name of the console for which messages need to be freed.

Rules

• You can only issue *FREE (without a console name) from an RJP console. This is called a non-directed *FREE command.
• You must have an authority level of 10 or greater to issue a non-directed *FREE from an RJP console.
• If *FREE is issued from an MCS console, an RJP console name must also be specified. Directing a command to a specific console is called a directed *FREE command.
• You must have MCS master authority or JES3 authority level 15 to issue directed *FREE commands.

Examples

*FREE

*FREE,RTM01