Mask for modifying individual Menu items

Possible entries in the Command field of the Modify Menu Item mask:

/cmd Any BS2000 command.

HC | NHC Set/reset Hardcopy mode.

MENU file A new menu file is read into memory. This file can then be processed in this same mask.

K1 Return to the Menu mask.

F3 Capture the current screen to the CFS hardcopy file.

"OC-Command" Field

Statements needed by CFS to open a Connection. A valid OC command should be entered in this field. The first three characters of the OC command (OCn) must not be specified. If nothing is specified in this field, a connection to $DIALOG on the users own host will be opened. The LOGON command must be executed manually by the user when the Connection is opened, or it can be specified in the "Commands after Open-Connection" field.

Examples:

$DIALOG,,HOST2/.&LOGNAM LOGON ......

&LOGNAM: CFS-specific procedure variable. It contains the Job name of the task from which CFS was loaded.

/LOGON userid,acct-#,&(jv-name)

The LOGON password is stored in the Job variable 'jv-name'.

OASE,CFS1

$CONSOLE,,HOST3,R

R: Automatic return to the Menu mask after opening the Connection.

"Comment" Field

The description of the process that will be displayed in the description column of the Menu mask can be entered here. Lower case letters will not be converted to upper case.

If nothing is specified in this field, the following parameters will appear in the description field after the Connection has been opened: partner name (e.g. $DIALOG), virtual terminal name, host name, and userid if the Connection is to $DIALOG.

"Program" Field

Abbreviated name for the Connection. This abbreviation will appear in the "Task" column of the Menu mask. No duplicate abbreviations are allowed in the same Menu mask. If lower case letters are used, they will be converted to upper case.

"Connection-number or space" Field

n 0 <= n <= 9 Fixed Connection number under which the Connection should be opened.

_ Blank: The Menu System will assign the next free number when attempting to open the Connection. Numbers that have been specified as fixed (see above), will have been reserved. The number allocated will be displayed in the # column of the Menu mask, following the Connection being successfully opened.

"Break (B) allowed (Y/N)" Field

B Entering 'B' for a Connection will allow the K2 key function to be transmitted in that Connection.

_ Blank: 'B' will be ignored, and the K2 function will not be transmitted for that Connection (necessary for UTM tasks).

"Plus-Module for P-keys" Field

Optional name of a PLUS module for a specific P-key assignment. The module must reside in PLUS.MAPLIB or in an LMS library previously assigned with /FILE file,LINK= MAPLIB.

"Commands after Open-Connection" Field

This area can contain up to 12 statements which will be sent to the Connection as a Startup sequence, following it being successfully opened. Lower case letters will be converted to upper case.

Any CFS procedure language statements ('*' statements) can be specified as Startup records. CFS-specific procedure variables can also be used. For a full description, see Chapter 19 "CFS Procedure Language".

Examples:

KDCSIGN ....

Connect to a UTM task

/DO procedure,(...)

Call a DO procedure after connecting to $DIALOG.

userid,C'passw'

Pass the message header when connecting to $CONSOLE.

RES file

Replay a captured dialog session.

Editing multiple lines in the "Commands after Open-Connection" field

Various editing facilities are available to delete, insert and copy existing lines. These commands should always appear at the beginning of the line to be edited.

,c Copy. The marked line is to be used as the source for a Copy operation. The line contents overwritten by the ,'c' operator will be copied as well.

,m Move. The marked line will be moved. The location to which it should be moved is defined by ',a', ',b' or ',o'. The line contents overwritten by the ',m' operator will remain unaltered.

,a After. The line marked with ',c' or ',m' will be inserted after this line. The line contents overwritten by the ',a' operator will remain unaltered.

,b Before. The line marked with ',c' or ',m' will be inserted before this line. The line contents overwritten by the ',b' operator will remain unaltered.

,o Over. This line will be overwritten with the contents of the line marked with ',c' or ',m'.

,d Delete. The marked line will be deleted.

,i Insert. A blank line will be inserted in front of the marked line.