This command sends a “break” signal to the currently connected host. The action depends on the setting of the BREAKACTION parameter.

This command sets the action to be taken if you issue a BREAK command. You do not normally have to set BREAKACTION, as the host should set the value it requires.

The syntax is:

BRA [


n]

where n is one of the following settings, causing the action described to be taken:

If you do not supply a parameter, the current setting is displayed.

This command allows you to alter the pad program recall character (the default is <Ctrl P>). There is no abbreviation.

This command attempts to set up a connection to the named host system with the requested facilities. Hosts can be specified by name or by address. The syntax is:

C 


host [


~CUD] [


facilities] [


G|


B[


CUG]] [


NNUI] [


TRPOA]

The various fields are described as follows.

The host field takes one of the following forms:

C host1

C 


S.LSAP[[


.N|


X]


.NSAP] [


~CUD] [


facilities] [


G|


B[


CUG]] [


NNUI] [


TRPOA]

C C.080069021CC57E.N.9999 

C 


S.DTE [[


.N|


X]


.NSAP] [


~CUD] [


facilities] [


G|


B[


CUG]] [


NNUI] [


TRPOA]

C host [~CUD] [facilities] [G|B[CUG]] [NNUI] [TRPOA]

Address components

The meanings of these fields are as follows:

Facility components

You can request any or all of the following facilities for the call. All these parameters are optional and your system administrator will have set up general default values or specific defaults for the host you have specified. These values are used if you leave them unspecified. See your system administrator for information on CUGs and other values for your system.

The facilities fields, entered as a string, are as follows:

Thus, the string may resemble this :

p7/7w2/2fr

This command closes the current connection.

The syntax is:

E [


on|


off] 

where:

If you do not supply a parameter, the current setting is displayed. The default setting is on.

Use this command to choose which characters are not echoed to the screen. The profile set by your system administrator also determines which characters are echoed to the screen. You should not need to change the echo mask.

The syntax is:

EM [


n]

where n is a mask that stops specified characters being echoed as shown in Table 2-1.

For example, to instruct the pad program not to echo the BEL and BS characters, use:

EM 8

To instruct the pad program not to echo a larger set of characters, add the values of the parameters. For example, if you do not want to echo VT, HT, FF or BEL or BS enter the following:

EM 12 

If no parameter is specified, the current value of the Echo Mask is reported. The default is 192 (128 + 64) so that “all other control characters” and DEL, CAN, and DC2 are not echoed.

This enables or disables the local flow control processing of IXOFF and IXON characters by the pad program. The syntax is:

F [


on|


off] 

where:

If you do not supply a parameter, the current state of the flow parameter is reported. The default is on, which enables the processing of IXOFF and IXON characters.

This selects the data forwarding characters. You do not normally have to change the setting of this parameter; your system administrator should have decided on a sensible value for you.

The syntax is:

FOR [


n]

The possible parameter settings are as follows:

Add two or more numbers together to forward a combination of the sets of characters. For example, to forward on alphanumeric characters (1) and ESC, BEL, ENQ, and ACK (4) enter:

for 5 

If you do not specify a parameter, the current setting is displayed. The default is 48 (16 + 32), so that ETX, EOT, HT, LF, VT, and FF are forwarding characters.

This command gives a one-line summary of a command or the full list of commands. An example screen is given later in this chapter, in the section “Command Summary”. The syntax is:

? [


command]

where command produces help for one command only. For example:

HELP breakaction 

displays the following:

BREAKACTION [n] (or BRA) - set breakaction

This command lists all the hosts available to you when using the pad program. These are hosts that have been set up in the hosts table by the system administrator. Both standard and abbreviated names are given. The table looks something like this:

AVAILABLE 
~~~~~~~~~~~~~~~ 
Name : Thirdfloor-mini-room4 
Alias: mini34
Name : Thirdfloor-mini-room3 
Alias: mini33
Name : Secondfloor-mini-room6 
Alias: mini26

The hosts table is scrolled using pg, (or the pager you define in the PAGER environment variable) to control the display. To see more host details when the screen is full, press Return. For details, refer to the pg(1) online reference manual page.

This command transmits an interrupt packet to the remote host. There is no abbreviation for this command.

This command governs whether or not a linefeed (LF) is inserted after a carriage return (CR). You should not normally have to set this parameter as the host should set an appropriate value. The syntax is:

LF [


n]

where n is one of the following:

Add two or more numbers together to set forwarding for a combination of the conditions for LF insertion. For example, to set LF insertion after CR in the data to and from the host, enter the following:

LF 3 

The value of this parameter has no effect in native mode unless echoing is on, in which case the setting of value 4 is allowed. (This is required because certain hosts operate in native mode, but leave local echo enabled.)

In transparent mode, the setting of value 1 has no effect.

If you do not supply a parameter, the current setting of the parameter is displayed. The default value is 6.

This command displays all incoming and outgoing X.29 messages to and from the host, for the purpose of fault diagnosis. You do not normally have to use this command. The syntax is:

LOG [


on|


off]

Parameter numbers and values are specified as pairs of hexadecimal numbers, separated by a space. The format of the message displayed is as follows:

X29 TX|RX Code <Parameter Value Parameter Value ....> 

TX is used to display values for transmitted messages, RX for received messages. For example:

The following message reads parameters 02, 04, and 0F hex:

X29 RX 4: 02 00 04 00 0F 00

The following message sets parameters 02, 04, and 0F hex to 01:

X29 RX 2: 02 01 04 01 0F 01

Messages beginning like the following are parameter indication messages, showing the current values of specified parameters:

X29 TX 0

The MESSAGE command sets the mode of operation to message mode. The parameter settings for message mode are shown in Table 2-2.

This means that echoing is on, the data forwarding timeout is off, the line folding width is 80, and local editing is allowed. For details of the modes see the subsection “Selecting an Operating Mode” in Chapter 1.

This is the default mode of operation. Refer to the NATIVE and TRANSPARENT commands for other operating modes.

This sets the mode of operation to native mode. The parameter settings for native mode are shown in Table 2-3.

This means that echoing is disabled, data forwarding timeout is enabled, there is no line folding, and local editing is disabled. For more information about the different types of operating mode, see the subsection “Selecting an Operating Mode” in Chapter 1.

The default operating mode is message mode.

Use this command to make the display pause after n lines. The syntax is:

PW [


n]

where n is the range for the pagewait parameter, 0 - 255. If n is set to 0, there is no pagewait and the display scrolls off the screen.

To continue after a pagewait, press the space bar. All other characters, with the exception of the BREAKIN character, are ignored.

If you do not supply a parameter, the current setting is displayed. The default is 0, meaning that any display that is too long will scroll off the screen.

This command displays the current values of all the X.3 parameters in parameter number:value pairs. For example, when the default settings for the V5 profile are being used, the PARAM command returns:

1:1 2:1 3:48 4:0 5:0 6:1 7:5 8:0 9:0 10:80 11:14 12:1 13:6 14:0 15:1 16:127 17:24 18:18 19:2 20:192 21:0 22:0

For an explanation of each of the parameters and their commonly used values, refer to the section“Parameter Values” in Chapter 3.

This command displays the current values of the parameters you specify in number:value pairs. This call has no abbreviation. The syntax is:

PAR? 


<par list> 

where <par list> is one or more numbers from the list presented in Chapter 3, separated by spaces or commas. For an explanation of the meaning and usage of the parameters, refer to the section “Parameter Values” in Chapter 3.

For example:

PAR? 2,4,10,15 

returns:

PAR 2:1, 4:0, 10:80, 15:1 

Separate the list of parameters you request with commas or spaces. If you do not specify parameters, all the parameters are displayed in number:value pairs.

This is used to tell the pad program that you are using a hard-copy terminal. This command and the VDU command set parameter 19. If you want to see the current value, use the PAR? command. The value 1 is for a hard-copy terminal, the value 2 is for a video display unit.

This command selects a set of terminal options pre-defined as a profile. These profiles contain default values for the X.3 parameters. The syntax is:

PROF [


p]

where p is the name of the profile in either uppercase or lowercase. The following example sets the V2 profile:

PROF V2 

The default profiles supplied are as detailed in “Parameter Values” in Chapter 3. Your system administrator can set the default profile and specify the set of usable profiles.

If you do not supply a parameter, the current profile will be displayed.

The QUIT command closes the connection and you exit the pad program to the system prompt.

This command sends a Reset Request to the currently connected host.

The SET command sets the parameters you specify to the values you supply. It lets you change the setting of parameters from the value used in the selected profile. Your system administrator can advise you about the profile and the parameter settings you should use. There is no abbreviation. The syntax is:

SET <parameter number:value, parameter number:value,...> 

The number of the parameter is followed by a colon and the desired parameter value. For example, to set parameters 2, 10, and 13, enter:

SET 2:1, 10:72, 13:4

Number:value pairs in a list should be separated by commas or spaces.

If you supply the name of a parameter without a value, or with an invalid value (for example 13:8 rather than 13:4 in the above example), a message in the form PAR 13:INV is returned and the value of the parameter remains unchanged.

This command sets the parameters you specify to the values you give. Unlike the SET command, this displays the parameters and the values you specify. The number of the parameter is followed by a colon and the setting you want the parameter to have. There is no abbreviation. The syntax is:

SET? 


<parameter number:value, parameter number:value,...> 

For example:

SET? 2:1,10:72,13:4 

returns:

PAR 2:1,10:72,13:4 

Number:value pairs in a list should be separated by commas or spaces.

If you supply the name of a parameter without a value, or with an invalid value (for example 13:8 rather than 13:4 in the above example), a message in the form PAR 13:INV is returned and the value of the parameter remains unchanged.

This command displays the status of the connection and the name of the host to which you are connected. If no parameter is specified, the current call connection status is reported. The syntax is:

STAT [


all]

where the parameter all produces further status information. For example:

Echo = ON, Echomask = 192, Flow = ON, Lfinsert = 6, Breakaction = 5 Pagewait = 0, Width = 80, Forward = 48, Timeout = 0, Message Mode Profile = V3, Vdu, Loghost = OFF
Call Status: Call Connected 
Host: centralhost

This command sets the mode of operation to transparent mode. The parameter settings for transparent mode are shown in Table 2-4.

This means that echoing is on, data forwarding is disabled, there is no line folding, and editing is enabled. For more details about the use of the different operating modes, see “Selecting an Operating Mode” in Chapter 1.

The default operating mode is message mode.

The VDU command (for video display unit) is used to tell the pad program that you are using a display terminal. There is no abbreviated form.

This command and the PRINTER command set parameter 19. If you want to see the current value, use the PAR? command. The value 1 is for a hard-copy terminal, and the value 2 is for a VDU (the default).

This is used to define the width of the terminal screen in use. On output, when this width is reached, a “newline” is inserted. The syntax is:

WID [


n]

where n is the screen width. The range for the parameter is 20 - 255. If you do not supply a parameter, the current setting is displayed. The default screen width is 80.

If you enter HELP or ? while using the pad program, a one-line description of each of the commands available in the current interface is displayed. The screen is scrolled using pg, (or the pager you define in the PAGER environment variable). Press Return to see the remaining display.

Table 2-5 provides a quick summary of the available commands. For more details about pg options, refer to the pg(1) online reference manual page.