March 1998
Newsletter

IOFTech    Maintenance   Release8G       Newsletters    Doc    FAQ    Contacts    Home    Webmaster

Customizing IOF Panel Formats

Topics

Simple CUT and PASTE Commands

The IOF Release 7D CUT and PASTE commands can be used to easily change the column arrangement of most IOF panels. To rearrange columns on a Release 7D panel:

For example, type CUT and point the CURSOR to the OWNER field as shown in the sample panel below. Press ENTER.

------------------------------ IOF Job List Menu -------------(  5 )-----------
COMMAND ===> CUT                                             SCROLL ===> CURSOR
--------------------------------- Output Jobs ---------------------------------
-------JOBNAME--JOBID--ACT-STAT-OWNER----DEST/DEVICE--------RECS-HELD-DAY--TIME
_    1 JOBARCH  J00551          SYSRHT   LOCAL               132      061 12:45
_    2 M88PANDF J09526          SYSRHT   LOCAL.SYSRHT       6262      036 13:21
_    3 IOFWTR   J09447          SYSRHT   LOCAL              3015   28 034 15:21
_    4 BATCHIOF J09081          SYSRHT   FETCH               223      029 17:56
_    5 JOBUPLOD J08773          SYSRHT   LOCAL                63      022 15:22

The OWNER column will be removed from the panel, and the fields to the right will be shifted to take it's place. The modified display is shown below.

------------------------------ IOF Job List Menu -------------(  5 )-----------
COMMAND ===> MAX                                             SCROLL ===> CURSOR
--------------------------------- Output Jobs ---------------------------------
-------JOBNAME--JOBID--ACT-STAT--DEST/DEVICE--------RECS-HELD-DAY--TIME--PAGES-
_    1 JOBARCH  J00551           LOCAL               132      061 12:45
_    2 M88PANDF J09526           LOCAL.SYSRHT       6262      036 13:21
_    3 IOFWTR   J09447           LOCAL              3015   28 034 15:21
_    4 BATCHIOF J09081           FETCH               223      029 17:56
_    5 JOBUPLOD J08773           LOCAL                63      022 15:22

Scroll to the extreme right by entering MAX in the command area and pressing PFKey 11. The new display is shown below.

------------------------------ IOF Job List Menu -------------(  5 )-----------
COMMAND ===> PASTE                                           SCROLL ===> CURSOR
--------------------------------- Output Jobs ---------------------------------
-------JOBNAME--JOBID--ACT-STAT-COMMENTS---------------------------------------
_    1 JOBARCH  J00551
_    2 M88PANDF J09526
_    3 IOFWTR   J09447
_    4 BATCHIOF J09081
_    5 JOBUPLOD J08773

Type PASTE in COMMAND as shown above, and point the cursor on any row in the COMMENTS field. The OWNER field that was previously CUT from the display will be inserted before COMMENTS.

The panel modifications are saved in the user's profile and will automatically be applied each time that user enters IOF.

If multiple fields are CUT before PASTE is entered, the fields will be pasted in the order in which they were cut.

Resetting to Default Format

To reset the Output Jobs Section to the default format, display any list of output jobs and enterB>ARRANGE DEFAULT in COMMAND as shown below. Panel modifications previously saved in the user's profile are removed. Note that the reset applies only to the section currently being displayed at the top of the screen. For example, if both input jobs and output jobs are being displayed on the Job List Menu, ARRANGE DEFAULT applies only to the type of job being displayed at the top of the screen.

------------------------------ IOF Job List Menu -------------(  2 )-----------
COMMAND ===> ARRANGE DEFAULT                                 SCROLL ===> CURSOR
--------------------------------- Output Jobs ---------------------------------
-------JOBNAME--JOBID--ACT-STAT-OWNER----DEST/DEVICE--------RECS-HELD-DAY--TIME
_    1 M86ISFCV J04823          SYSMVS   LOCAL              1902      301 10:09
_    2 IOFWTR   J04650          SYSMVS   LOCAL              1416   15 297 16:04

CUT, PASTE and ARRANGE can be entered on the following IOF panels:

CUT, PASTE and ARRANGE Command Syntax

Most users can tailor their panels using CUT and PASTE as described above. ARRANGE DEFAULT can be used to reset to the default panels when required. More sophisticated users may want to use the full function CUT, PASTE and ARRANGE facilities either directly from the terminal or in Rexx execs and clists. Full function commands are required when issued from a Rexx exec or clist.

CUT Command Syntax

CUT [field]

field is the name of the field to be moved.

If field is not specified, the field pointed to by the cursor is cut from the panel. Non-scrollable fields can not be CUT.

PASTE Command Syntax

PASTE [BEFORE/AFTER/FIRST/LAST] [field]

BEFORE means insert before the specified field.
AFTER means insert after the specified field.
FIRST inserts to the right of the last non-scrollable field.
LAST sets the target to the to the far right of the screen.
field is the name of the target field.

If field is not specified, then the field pointed to by the cursor is used as the target field. BEFORE is the default if neither BEFORE, AFTER, FIRST or LAST is specified. You can not PASTE into the non-scrollable fields to the left of the panel.

ARRANGE Command Syntax

ARRANGE [field1] [FIRST/LAST/BEFORE/AFTER] [field2]

field1 is the field to be moved.
FIRST sets field1 as the first non-scrollable field.
LAST sets field1 as the last field on the panel.
BEFORE moves field1 before field2.
AFTER moves field1 after field2.
field2 is the name of the target field.

ARRANGE DEFAULT

DEFAULT means reset the section to the default format.

ARRANGE $TEMP

$TEMP temporarily sets CUT, PASTE and ARRANGE format changes for the duration of the current IOF panel display only.

ARRANGE is the recommended command to be issued from Rexx execs or clists to modify panel formats.

Examples

ARRANGE DEFAULT Revert to the default panel format
ARRANGE $TEMP All CUT, PASTE and ARRANGE commands that follow are temporary
CUT Remove the field under the cursor
CUT PAGEDEF Remove the PAGEDEF field
PASTE AFTER FORMS Insert the previously cut fields after the FORMS field
ARRANGE OWNER LAST Move the OWNER field to the far right of the panel
ARRANGE COMMENTS FIRST Move the COMMENTS to the first non-scrollable field
ARRANGE CLASS BEFORE FORMS Position the CLASS field to the left of the FORMS field
ARRANGE USERNAME AFTER AGE Position the USERNAME to the right of the AGE field

Using Rexx or Clists to Modify Panel Formats

A Rexx exec or clist can be used to simplify modifications that would otherwise require multiple CUT, PASTE or ARRANGE commands.

Assume that a group of operators prefers to modify the Output Group Display to make CLASS, FORMS, UCS and FCB the first four non-scrollable fields. This can be accomplished with the OPERFORM clist shown below.

/*- OPERFORM Clist to modify the Output Group Display -----------------------*/

ARRANGE CLASS FIRST
ARRANGE FORMS AFTER CLASS
ARRANGE UCS AFTER FORMS
ARRANGE FCB AFTER UCS

From the Output Group Display, enter %OPERFORM to execute the 4 ARRANGE commands required to modify the panel format as required. The panel format changes are saved in the operator's profile so that the clist needs to be executed only one time by each operator.

Clists and Rexx execs can be programmed to adapt to the environment, and to react to input parameters. This is easily demonstrated with the IOFFMT sample Rexx exec. Specifications for the exec are:

Click here to see the IOFFMT Rexx exec described above.

Installation Wide Panel Format Modifications

Some installations may need permanent modifications to IOF panel formats for everyone, or for special groups of users. The B68FORMT member of the IOF OPTIONS library can be used to make global modifications where required. Instructions are included in the B68FORMT member.


Triangle Systems, Inc. PO Box 12752, Research Triangle Park, NC 27709
Email
IOFTech@Triangle-Systems.Com

[an error occurred while processing this directive]