NAF - Header Page - Function 31.5

#### Search Results

Search

# NAF - Header Page - Function 31.5

You can define a header page that is to be printed in front of each report.

This documentcovers the following topics:

- Invoking Header Page

- Selecting a Header Page from a List

- Maintaining a Header Page

## Invoking Header Page

When you invoke this function, the Header Page window appears:

    Time 15:59:41        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +--------- Header Page 7/411 ------------+
            Administration                 !                                        !
                                           !  Enter name of                         !
            10 Reports / Queues            !                                        !
            11 Devices                     !       Header Page                      !
            12 Abstracts                   !                                        !
            13 Applications                !  or                                    !
            14 Change Spool File           !                                        !
                                           !      *    for Selection                !
            Maintenance                    !                                        !
                                           !      ?    for Help                     !
            30 Spool File Properties       !                                        !
            31 Objects                     !      .    for End                      !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !      -------------------------         !
            34 Transfer Objects            !      / ________ /                      !
                                           !                                        !
                                           +----------------------------------------+
      Enter values.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  User  Logic Alloc Print Heade Appli       NTCC  Canc

In this window, you can specify the name of an existing header page, select a header page from a list of header pages available or add a new header page to the spool file.

## Selecting a Header Page from a List

To select a header page from a list, enter one of the following:

- a partly-qualified name (e.g. `S*` to list all header pages starting alphabetically from S),

- an asterisk (*) to list all header pages in the `NATSPOOL` system.

A list of header pages is then shown in a window.

    Time 16:13:44        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                            M e n u                    File 7/411
                                           +-------------Select with *--------------+
            Administration                 !  New start value ......... _________   !
                                           !  -----------------------------------   !
            10 Reports / Queues            !  Fl Cm  Name        Fl Cm  Name        !
            11 Devices                     !  -- --  ---------   -- --  ---------   !
            12 Abstracts                   !      _  NAFSTDHP        _  STDHEAD     !
            13 Applications                !                                        !
            14 Change Spool File           !                                        !
                                           !                                        !
            Maintenance                    !                                        !
                                           !                                        !
            30 Spool File Properties       !                                        !
            31 Objects                     !                                        !
            32 Mass Update                 !                                        !
            33 Hardcopy Allocations        !                                        !
            34 Transfer Objects            !                                        !
                                           !                                        !
                                           +----------------------------------------+
      Mark on selection list.
      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit                     --                           Canc

The header pages defined for the allocations that were used for the initialization of the current Natural session are highlighted in the window.

In the `Cm` column, you can enter one of the following codes:

Code | Description
--- | ---
`C` | Copy header page.
`D` | Delete header page.
`R` | Rename header page.
`.` | Exit function.
`X` or any other character | Display header page for modification or deletion, see below.

## Maintaining a Header Page

If the specified header page exists, it is displayed. You can modify the header page or delete it.

Note
If you specify a name that does not yet exist, you can add a new header page. In this case, the Delete option is not provided in the window.

The standard header page `NAFSTDHP` can be used as a template for your own header pages. This header page is protected and can only be displayed/modified by using the password for the spool file.

    Time 14:13:18        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                     Header Page NAFSTDHP              File 7/411

      Name of header page   NAFSTDHP  Internal FFFFFFFF   Delete (Y/N)           N
      Owner  N
      Allowed number of columns  130   / lines    62      current last line     49

     Col/   1        11        21        31        41        51        61        71
     Line   I---------I---------I---------I---------I---------I---------I---------I
      1
      2                   SSSSSSSSSSSSSSSSS                     SOFTWARE  AG
      3                 SSSSSSSSSSSSSSSSSSS
      4               SSSSSSSSSSSSSSSSSSSSS                     Darmstadt - Ebersta
      5              SSSSSSSS
      6              SSSSSSS
      7              SSSSSSS       SSSSSSSS
      8              SSSSSSS       SSSSSSSS
      9              SSSSSSS       SSSSSSSS
      10             SSSSSSS       SSSSSSSS                     NATURAL SPOOL OUTPU

     Modify values for the header page.
     Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit  Store  <<    --     -    +    Full   <     >    Canc

Each header page may be up to 62 lines long and 130 columns wide. It may contain free text as well as keywords that are replaced during printing.

You can insert the following keywords in your header page:

Keyword | Description
--- | ---
`NAFCC` | Function (start, restart etc.).
`NAFJB` | Job number.
`NAFDT` | Current date.
`NAFTI` | Current time.
`NAFID` | User ID for the report.
`NAFDF` | Allocation for the report.
`NAFNA` | Report name from `DEFINE PRINTER` statement.
`NAFPR` | NTCC table name (profile).
`NAFFO` | Form name from `DEFINE PRINTER` statement.
`NAFLP` | Logical printer for the report.
`NAFCD` | Date of report creation.
`NAFCT` | Time of report creation.
`NAFPG` | Program name.
`NAFLI` | Library name.

The keywords above must be entered in upper-case letters. For an example, see the screen below.

    Time 12:19:35        *** Natural Spool Administration ***      Date 2022-04-06
    User SAG                      Header Page NAFSTDHP             File 7/411

       Name of header page    NAFSTDHP   Intern  FFFFFFFF   Delete (Y/N)           N
       Owner  N
       Allowed number of columns  130   / lines    62      current last line     49

      Col/  11        21        31        41        51        61        71        81
      Line   I---------I---------I---------I---------I---------I---------I---------I
       31     I                                                                I
       32     I                                                                I
       33     I Spool  Function    :  NAFFC                                    I
       34     I                                                                I
       35     I Current Date       :  NAFDT         Current Time    : NAFTI    I
       36     I                                                                I
       37     I Job Number         :  NAFJB         User ID         : NAFID    I
       38     I                                                                I
       39     I Destination / Form :  NAFDF         Logical Printer : NAFLP    I
       40     I                                                                I

      Modify values for header page.
      Command ==>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  Store  <<    --     -    +    Full   <     >    Canc

You can use the following standard Natural editor line commands with all possible combinations, such as `.CX-Y` (see the online help):

- `.X`

- `.Y`

- `.C`

- `.D`

- `.M`

- `.I`

To store the header page, press PF4.

### On this page

- Invoking Header Page
- Selecting a Header Page from a List
- Maintaining a Header Page