Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

Customized layout

&pagelevel(4)&pagelevel

The standard layout offered by MAREN can be modified, or even be completely redesigned from scratch. A customized layout must be stored in a file. This file name can be freely selected (see also “Dummy release items” (Installation with IMON)). The file must possess the following attributes:
ACCESS-METHOD=SAM,RECORD-FORMAT=V,USER-ACCESS=ALL-USERS,ACCESS=READ

In a network, the file must, when necessary, be available on every system, although layouts can be different. The standard layout is used on all systems where this file is not available.

There are no restrictions on the characters used in the layout file, i.e. special characters and non-printable characters are supported. The MAREN administrator is entirely responsible for how the export receipt is actually output on the printer.

There is no limit on the number of records. The individual records can contain up to 141 characters (including the record length field).

So-called layout variables are defined to allow the export receipts to be provided with current values. They are 7 or 8 characters long and all begin with the character '&'. MAREN searches the layout file for these variables. Each record of the layout file can contain any number of variables at any position. This is limited only by the maximum length of the record.

Variables can be used more than once. When an export receipt is generated, the layout file is read record by record, all variables are replaced by current values, and all the records are written to the output file.

Name       LengthMeaning                                                           
&ACCNT8*8ACCESS-COUNT
&ACCOUNT8ACCOUNT
&ADMFIEL8ADMINISTRATOR-FIELD
&ADMFI2*16ADMINISTRATOR-FIELD-2
&ARCHUSA54FREE-POOL
&AUDITV*3AUDIT
&CHECNT*2CHECK-COUNT
&CLOSEI*6CLOSE-INDICATOR
&CRECAT*4CREATION-CATALOG-ID
&CREDATE10CREATION-DATE
&CREJOBN8CREATION-JOB-NAME
&CRETIME8CREATION-TIME
&CREUSID8CREATION-USER-ID
&DEVNAM*4DEVICE-NAME
&DEVTYPE8DEVICE-TYPE
&DIRNAME54DIRECTORY-NAME
&DIROVOL3DIRECTORY-ON-VOLUME
&DOMAIN8DOMAIN
&EXPADDR50EXPORT-ADDRESS
&EXPDATE10EXPORT-DATE
&EXPIRAT10EXPIRATION-DATE
&FILENAM41FILE-NAME
&FILSEQ*4FILE-SEQ
&FIRSTV*6FIRST-VOLUME
&FREDATE10FREE-DATE
&FREELOC8FREE-LOCATION
&HOMELOC8HOME-LOCATION
&INITFL*3INITIALIZATION
&LACACCO8LAST-ACC-ACCOUNT
&LACCPUN8LAST-ACC-HOSTNAME
&LACDATE10LAST-ACC-DATE
&LACFFL*2LAST-ACC-FUNCTION-FLAG
&LACFNAM8LAST-ACC-FUNCTION-NAME
&LACJOBN8LAST-ACC-JOB-NAME
&LACSNO*3LAST-ACC-SNO
&LACTIME8LAST-ACC-TIME
&LACTSN*4LAST-ACC-TSN
&LACUSER8LAST-ACC-USER-ID
&LATEMPL8Last temporary location
&LAWRBCN10LAST-WRITE-BLOCK-CNT
&LCLDATE10LAST-CLOSE-DATE
&LCLTIME8LAST-CLOSE-TIME
&OPENMOD8OPEN-MODE
&ORDACCO8Ordering account number 
&ORDCPUN8Ordering system name
&ORDJOBN8Ordering job name
&ORDTSN*4Ordering TSN
&ORDUSER8Ordering user ID
&PASSWO*4PASSWORD
&REGDATE10REGISTRATION-DATE
&REMARKF24REMARK
&REMAR210REMARK -2
&REMAR312REMARK -3
&RESCNT*4RESERVATION-COUNT
&RESDATE10RESERVATION-DATE
&SUBSAVE2SubSave #
&SUBSEQU3SubSequence #
&SVIDSFI15SVID / SFID from ARCHIVE/HSMS 
&TEMPLOC8TEMP-LOCATION
&TODDATE10Creation date for the receipt
&TODTIME8Creation time for the receipt
&USERACC12USER-ACCESS
&USERFIE54USER-FIELD
&USERIDE8USER-ID
&VOLGROU32VOLUME-GROUP
&VOLSEQ*4VOLUME-SEQUENCE
&VOLSTAT8VOLUME-STATUS
&VOLUME*6VOLUME-VSN

Those variables which end with an asterisk can be specified using 7 characters (without *) or 8 characters (with *).
Since the length of variables names (7 or 8 characters) is generally not the same as the length of the current values (2 to 54 characters), a number of rules must be observed when designing a layout.

Case 1:

All variables are specified with 8 characters (i.e. using * where applicable) and (if the length > 8) padded with blanks on the right to allow sufficient space for the current values to be incorporated in their entirety. This ensures that text is not misplaced when the export receipt is generated. This procedure has the advantage that the complete layout including all texts (particularly the right margin characters) can be designed with everything in the correct position. Current values with lengths between 2 and 6 are padded with blanks to a length of 8 characters.

Example

The following layout lines:
   $&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&$
   $          VSN = &VOLUME*                        FSEQ = &FILSEQ*        $
   $                                                                       $
   $       REMARK = &REMARKF                                               $
   $      ACCESS# = &ACCCNT*                       SHARE = &USERACC        $
   $&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&$
produce the following printed lines:
   $&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&$
   $          VSN = TAPE01                          FSEQ = 0001            $
   $                                                                       $
   $       REMARK = FILE BACKUP FEBRUARY                                   $
   $      ACCESS# = 0005                           SHARE = FOREIGN-READ    $
   $&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&$

Case 2:

If the current value of a layout variable is not required in its full length, the output length can be restricted by any character other than a blank. The minimum length is 8 characters.

Example

Only the first 20 characters of the file name are to be output. The following layout line :
| FILENAME = &FILENAM * |

would produce the following printed line for the current value FILE-BACKUP-LIST.FEBRUARY:
| FILENAME = FILE-BACKUP-LIST.FEB |

Case 3:

By default, the current values for layout variables with a terminating asterisk are padded with blanks to a length of 8 characters. If this padding is not required, the variable names must be specified with 7 characters (i.e. without *).

Example

The following layout lines:
+-----------------+
| &VOLUME/&FILSEQ |
+-----------------+
produce the following printed lines:
+-------------+    
| TAPE01/0001 |    
+-------------+    

Powered by Atlassian Confluence and Scroll Viewport.