%DUMP CHANNELS--List PSL Global Channels

List the open PSL global process and file channels.

Syntax

 %DUMP CHANNELS

Parameters

This command has no parameters.

Description

The %DUMP CHANNELS command returns a list of global file and process channels opened using either the fopen() or popen() functions. The output from the %DUMP CHANNELS command contains the same information as that provided by the get_chan_info() function within a PSL program. The PSL interpreter returns the list of global channel information to the console window from which the %DUMP CHANNELS command was executed.

Note

The %DUMP CHANNELS command is one of a series of dump commands available from the command line. Use the %DUMP command (no argument) to obtain a list of items that can be dumped.

Each line of output from the %DUMP CHANNELS command is a string with the format: name, status, details, type, readname, readpid, writepid, writename. These string types are described in the following table.

Field

Definition

name

Alphanumeric name given to the channel when it was created as a global channel, or when it was changed from local channel to a global channel

status

OPEN or CLOSED

details

one of the following:

  • fopen() channel—file name that is opened or NONE if no file name is opened
  • popen() channel—process ID of the external operating system process to which the channel is attached or –1 if the process has terminated

type

PIPE or FILE

readname

one of the following:

  • Name of the process waiting to read from the channel
  • NONE if no process is waiting
  • UNAVAILABLE if there is a process but the name is not available

readpid

one of the following:

  • process ID of the PSL process waiting to read from the channel
  • –1 if no process is waiting

writepid

one of the following:

  • process ID of the PSL process waiting to write to the channel
  • –1 if no process is waiting

writename

one of the following:

  • name of the process waiting to write to the channel
  • NONE if no process is waiting
  • UNAVAILABLE if there is a process but the name is not available

Where to go from heree

PSL-External-Commands