SYSPARM Utility

#### Search Results

Search

# SYSPARM Utility

The SYSPARM utility is used to create and maintain a set of Natural profile parameters as an individual parameter profile that can be used for each Natural session.

When invoking Natural with dynamic profile parameters, you can specify individual parameters each time you invoke Natural. More comfortably, however, you can specify a set of parameters once in SYSPARM, store this set under a parameter profile name, and then invoke Natural with only one dynamic parameter: `PROFILE=profile-name`. The parameters defined in this parameter profile are then passed to Natural as dynamic parameters and must therefore comply with the syntax of `PROFILE` described in the Parameter Reference documentation.

For descriptions of the individual profile parameters that can be defined in a parameter profile, refer to the Parameter Reference documentation.

The parameter profiles are stored under user-defined names in the specified FNAT or FUSER Natural system file.

You can restrict the use of a parameter profile to specific users by setting the profile parameter `USER` as described in the Parameter Reference documentation.

The SYSPARM Utility documentation covers the following topics:

- Invoking SYSPARM

- List Profiles

- Display Profile

- Add New Profile

- Modify Profile

- Editing Profiles

- Copy Profile

- Delete Profile

- Direct Commands and Batch Processing

- Maintaining Profiles in Different Environments

- Invoking Help on Parameters from the Command Line

#### Related Topic:

- `PROFILE` in the Parameter Reference documentation

## Invoking SYSPARM

To invoke the SYSPARM utility

- Issue the following Natural system command:

      SYSPARM

  The Menu of the SYSPARM utility is displayed which provides the following functions and fields:

  Field/Function | Explanation
  --- | ---
  List Profiles | Displays a list of all parameter profiles. From the list, you can select one or more profiles for display, modification or deletion.
  Display Profile | Displays a specific parameter profile.
  Add New Profile | Creates a new parameter profile.
  Modify Profile | Changes an existing parameter profile.
  Copy Profile | Creates a new parameter profile by copying an existing one.
  Delete Profile | Deletes an existing parameter profile.
  Profile | Selects the specified parameter profile. Enter a valid profile name or use asterisk (*) notation to select a range of profiles. Use asterisk (*) or leave this field blank to select all profiles available.
  Copy to | Copies the specified parameter profile.
  DBID | Selects the database ID (DBID) of the Natural system file where the parameter profile is stored. Default is the current FPROF (if set), or current FNAT otherwise.
  FNR | Selects the file number (FNR) of the Natural system file where the parameter profile is stored. Default is the current FPROF (if set), or current FNAT otherwise.
  Password | Specifies the password (8 characters) of the Adabas file where the parameter profile is stored.
  Cipher | Specifies the cipher code (8 digits) of the Adabas file where the parameter profile is stored.

  The SYSPARM functions listed above are described in the remainder of this documentation.

## List Profiles

This function is used to list all parameter profiles contained in the specified Natural system file. From the parameter profile list, you can view, modify or delete one or more profiles. You can also display a property such as the code page of a parameter profile or when and by whom it has been modified at last.

To list parameter profiles

- In the SYSPARM Menu, enter function code `L` and, in the Profile field, enter the name of a parameter profile or specify a range of names:

  - Enter an asterisk (*) or leave the field blank to list all parameter profiles.

  - Use asterisk (*) notation to list all parameter profiles with names that start with a specified value, where value is any combination of one or more characters, for example: `ABC*`

  - Use the greater than (>) sign to list all parameter profiles with names greater than or equal to a specified value, for example: `ABC>`

  - Use the less than (<) sign to list all parameter profiles with names less than a specified value, for example: `ABC<`.

  The List Profiles screen is displayed with a list of all parameter profiles of the specified name range.

  You can press PF7 and PF8 to scroll up or down one page in the list. You can also press PF11 (>/<) to toggle properties of the profile, such as when (Date, Time) and by whom (User ID) the profile has been modified at last, the Natural version (Version) that was current when the file has been modified and the code page of the profile (Code Page).

  Note:
  If an entry for Code Page contains more than 17 characters, it is truncated. You can recognize a truncated entry from the trailing greater than sign (>). By pressing PF11 (>) once more, the code page's full name is displayed.

To view, modify or delete a single parameter profile

- Place the cursor anywhere in the Sel. or Profile column of the parameter profile you want to process and press one of the following PF keys:

  PF Key | Line Command | Function
  --- | --- | ---
  PF4 | `D` | Invokes the Display Profile function.
  PF5 | `M` | Invokes the Modify Profile function.
  PF6 | `X` | Invokes the Delete Profile function.

  Or:
  In the Sel. column, next to the parameter profile you want to process, enter one of the line commands listed above and press ENTER.

  Depending on the key pressed or line command entered, the selected parameter profile is either displayed on the screen or a delete confirmation window opens for this profile.

To view, modify or delete multiple parameter profiles

1. In the Sel. column, next to the parameter profiles you want to process, enter one of the line commands listed in the table above.

   You can use PF7 or PF8 to scroll up or down in the list of parameter profiles to go to the required items.

2. Press ENTER when you have finished entering all line commands for all parameter profiles.

   Depending on the line command entered, the first parameter profile selected is either displayed on the screen or a delete confirmation window opens for this profile.

3. When finished with the first parameter profile, press PF3 or PF12 to process the next parameter profile. PF3 also saves the current parameter profile, if modified.

## Display Profile

This function is used to display a parameter profile.

To display a parameter profile

- In the SYSPARM Menu, enter function code `D` and the name of an existing parameter profile.

  Or:
  From the List Profiles screen, select one or more parameter profiles as described in the relevant section.

  A Display Profile screen similar to the example below appears with the parameter definitions of the specified parameter profile:

       11:18:48             ***** NATURAL SYSPARM UTILITY *****            2019-10-08
                            - Display Profile TESTPROF (10,32) -
       >  /* This is a test profile. */                                             <
       >  AUTO=ON FNAT = (102,110,PASSWORD) FUSER=(1099,1100,PASSWORD,12345678)     <
       >  RPC=(RPCSIZE=80,SRVNAME=MYSERV,SERVER=ON,DFS=(SRV2,NODE1,,ACI),           <
       >  SRVUSER=sag)                                                              <
       >  PRINT=((2,12,18),AM=STD,DEST='PRINT**',OPEN=INITOBJ,CLOSE=CMD)            <
       >  PRINT=((1,3,6-11,15),AM=NAF)                                              <
       >  ESIZE=90                                                                  <
       >                                                                            <
       >                                                                            <
       >                                                                            <
       >                                                                            <
       >                                                                            <
       >                                                                            <
       >                                                                            <
       >                                                                            <
       >                                                                            <
       >                                                                            <
       >                                                                            <

      Command ===>

      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help        Exit        Modif                                     Canc

  The screen title indicates the name of the parameter profile (here: `TESTPROF`) and the database ID and file number (here: `10,32`) where the parameter profile is stored.

## Add New Profile

This function is used to create a new parameter profile.

To create a parameter profile

- In the SYSPARM Menu, enter function code `A` and the name of the parameter profile you want to create, and press ENTER.

  A blank edit screen appears. For instructions on entering the parameters you want to specify in the new parameter profile, see Editing Profiles.

## Modify Profile

This function is used to change the parameter specifications of a parameter profile.

To modify a parameter profile

- In the SYSPARM Menu, enter function code `M` and the name of an existing parameter profile, and press ENTER.

  Or:
  Invoke the Display Profile screen for an existing parameter profile and press PF5.

  Or:
  Invoke the List Profiles screen and select one or more parameter profiles as described in the relevant section.

  An edit screen with the parameter definitions of the specified parameter profile appears. For instructions on using this screen to add or modify definitions, see Editing Profiles.

## Editing Profiles

The edit screen of the SYSPARM utility appears when executing the Add New Profile or the Modify Profile function. This screen is used to enter the parameter specifications you want to include in a parameter profile. For detailed information about the profile parameters available, refer to the Parameter Reference documentation or use the `HELP *` command, see Invoking Help on Parameters from the Command Line.

The edit screen looks similar to the example below:

     11:22:28             ***** NATURAL SYSPARM UTILITY *****            2019-10-08
     >  /* This is a test profile. */                                             <
     >  AUTO=ON FNAT = (102,110,PASSWORD) FUSER=(1099,1100,PASSWORD,12345678)     <
     >  RPC=(RPCSIZE=80,SRVNAME=MYSERV,SERVER=ON,DFS=(SRV2,NODE1,,ACI),           <
     >  SRVUSER=sag)                                                              <
     >  PRINT=((2,12,18),AM=STD,DEST='PRINT**',OPEN=INITOBJ,CLOSE=CMD)            <
     >  PRINT=((1,3,6-11,15),AM=NAF)                                              <
     >  ESIZE=90                                                                  <
     >                                                                            <
     >                                                                            <
     >                                                                            <
     >                                                                            <
     >                                                                            <
     >                                                                            <
     >                                                                            <
     >                                                                            <
     >                                                                            <
     >                                                                            <
     >                                                                            <
    Help with parameters .. _______             Lower=ON   (Profile name: TESTPROF)

    Command ===>

    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit  Check Save                    Insrt Del   Copy  Canc

The name of the current profile is indicated in the Profile name field (here: `TESTPROF`). Use of the Help with parameters field is explained in Help with Parameters.

The edit screen contains 18 input lines (marked with `>`) with a maximum length of 72 characters each. The individual parameters entered must be separated from one another by (one or more) blanks or commas. You can spread the specifications of the parameters over as many lines as you like.

You can enter a commentary text in each input line, or spread a comment over as many lines as you like. Comments must be preceded by `/*` and followed by `*/` as indicated in the example above.

If conversion to uppercase letters has been deactivated, `Lower=ON` is displayed next to the Profile name field (see also the `LOWER` keyword of the `SYSPARM` command).

This section covers the following topics:

- Using the PROFILE Profile Parameter

- PF Keys

- Help with Parameters

### Using the PROFILE Profile Parameter

If you need additional space for editing or want to combine different parameter profiles or group parameter profiles by categories, concatenate multiple parameter profiles by entering the `PROFILE` profile parameter as the last entry in the profile(s) concerned. The first parameter profile then evaluates the parameter strings specified in the second parameter profile as part of the string of the first parameter profile.

For example:

`PROFILE=P2` entered at the end in parameter profile P1, and `PROFILE=P3` entered at the end in parameter profile P2, firstly invokes P1 and then P2 followed by P3.

For detailed information on the `PROFILE` parameter, see the relevant section in the Parameter Reference documentation.

### PF Keys

The following PF keys are available on the edit screen:

PF Key | Function
--- | ---
PF4 | Checks whether the parameter specifications within the parameter profile are syntactically correct.
PF5 | Stores the parameter profile.
PF9 | Inserts one blank line below the line containing the cursor.
PF10 | Deletes the line containing the cursor.
PF11 | Copies the line containing the cursor.

### Help with Parameters

The Help with parameters field on the edit screen can be used to obtain help information on valid parameter specifications and incorporate new specifications into the current parameter profile.

To view online help and include new parameters

1. In the Help with parameters field, enter one of the following:

   - The name of the required parameter.

   - One or more characters with asterisk (*) notation (for example, `PR*`) for all parameters whose names start with the specified character(s).

   - An asterisk (*) for all parameters available.

2. Do not press ENTER yet if you want to insert a new parameter specification into an existing parameter profile and proceed with the following step.

   Mark the input line below which you want to insert the new parameter specification(s) by placing the cursor on this line, and then press ENTER.

   Or:
   Press ENTER if you want to append a new parameter specification to the end of the parameter profile.

3. After performing the previous step, depending on the parameter value entered earlier, one of the following appears:

   - If you entered a full name, a help screen (see below) appears.

   - If you specified a name range using the asterisk (*), a window opens with a list of all parameters of the specified range.

     From this list, select the required parameter by entering any character in the input field next to the required parameter and pressing ENTER.

   The help screen looks similar to the example below:

       13:08:21             ***** NATURAL SYSPARM UTILITY *****            2009-02-11

         The parameter AUTO is used to cause an automatic logon at the start
         of the Natural session.

         AUTO=ON     An automatic logon is executed at the start of the Natural
                     session. The value contained in the Natural system variable
                     *INIT-USER is used as the user ID for the logon.
         AUTO=OFF    No automatic logon is performed.

          Enter your parameter specification:                 More Help:   (+,-)
        >
        >
        >
        >
        >

       Command==>

       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        Exit  Check                                           Canc

   The upper screen section contains help text on the specified parameter (in the example above, `AUTO`). If the text contains more than one page, you can enter a plus (+) sign before the More Help field to display the next page. Enter a minus (-) sign to return to the previous screen or enter a period (.) to terminate the help function and return to the edit screen.

   The lower section contains five input lines (marked with `>`).

4. Press ENTER.

5. In the input lines, enter the required parameter specifications.

   You can press PF4 to check the specifications.

6. Press PF3 to terminate the help function.

   The edit screen appears with the new parameter specifications either appended to the end of the parameter profile or inserted below the input line marked with the cursor in Step 3.

Note
See Invoking Help on Parameters from the Command Line for invoking help on parameters and subparameters from the command line.

## Copy Profile

This function is used to copy parameter profiles.

To copy a parameter profile

1. In the SYSPARM Menu, enter the following:

   - Function code `C`.

   - In the Profile field, the name of the parameter profile from which you want to copy the new parameter profile.

   - In the Copy to field, the name of the new parameter profile.

2. Press ENTER.

   A message appears indicating successful completion of the copy operation.

## Delete Profile

This function is used to delete an existing parameter profile.

To delete a parameter profile

1. In the SYSPARM Menu, enter function code `X` and the name of the parameter profile you want to delete, and press ENTER.

   Or:
   Invoke the List Profiles screen and select one or more parameter profiles as described in the relevant section.

   A Delete a Profile window opens with the name of the parameter profile you want to delete.

2. Confirm the deletion by entering the name of the parameter profile in the input field and pressing ENTER.

   You can cancel a delete operation by pressing PF3 or leaving the input field blank and pressing ENTER.

   A message appears indicating either successful completion or cancellation of the delete operation.

## Direct Commands and Batch Processing

The SYSPARM utility functions described earlier can also be executed by using corresponding `SYSPARM` commands in batch or online mode.

In addition to the functions provided on the SYSPARM utility screens, in batch mode, options are provided for specifying commentary text, the input delimiter and the input assign character.

The symbols used in the syntax diagrams shown in this section are explained in System Command Syntax in the System Commands documentation.

This section covers the following topics:

- Basic Command Syntax

- where-clause

- with-clause

- Batch Processing

- Example of SYSPARM in Batch

### Basic Command Syntax

Displayed below is the basic syntax that applies when processing `SYSPARM` commands.

[SYSPARM] |  |  | `ADD` `MODIFY` `DISPLAY` `LIST` |  | profile-name [where-clause] [with-clause] |  | `...`
| `DELETE` `X` |  | profile-name [where-clause]
| `COPY` |  | profile-name1 `TO` profile-name2 [where-clause]
| `ASSIGN` `DELIMITER` |  | [character]
| `LOWER` |  | `ON` `OFF` |  |
| `COMMENT` |  | `ON` `OFF` |  | [comment] |
| `TERM1ST` |  | `ON` [`WITH` return-code] |  |  |  |  |  |  |  |  |  |
`OFF` |  | `WITH` return-code `RESET` |

The keywords, the variable values to be supplied with the keywords, and the optional clauses indicated in the basic syntax of the `SYSPARM` command are described in the following table.

Note
If the `SYSPARM` command does not recognize a keyword provided with the command in batch mode, the input data is stacked and the batch session ends.

Keyword | Explanation
--- | ---
`SYSPARM` | Invokes the SYSPARM utility. This keyword is only required when executing `SYSPARM` commands from the NEXT or MORE prompt.
`ADD` | Executes the Add New Profile function.
`MODIFY` | Executes the Modify Profile function. To insert a commentary text into a parameter profile, place the comment between the characters `/*` and `*/`. See also Example Input.
`DISPLAY` | Executes the Display Profile function.
`LIST` | Executes the List Profiles function.
`DELETE` or `X` | Executes the Delete Profile function.
`COPY` | Executes the Copy Profile function.
`ASSIGN` | Specifies or displays the input assign character. You need to change the input assign character before you start processing data that contains the input assign character defined for your current session. Otherwise, you will receive an appropriate Natural system error. If no value is specified, the output contains the character defined for your current session.
`DELIMITER` | Specifies or displays the input delimiter character. You need to change the input delimiter character before you start processing data that contains the input delimiter character defined for your current session. Otherwise, you will receive an appropriate Natural system error. If no value is specified, the output contains the character defined for your current session.
`LOWER` | Determines whether the content of the profile is converted to uppercase letters when a profile is added or modified. Possible values are:
`OFF` | Letters are converted to uppercase (default). Letters enclosed in apostrophes (`''`) or contained in comments are not converted.
`ON` | Letters are not converted to uppercase. Note If `ON` is set, `LOWER=ON` is indicated on the edit screen of the SYSPARM utility (see Editing Profiles).
If the `LOWER` keyword is supplied in the `with-clause` of a `SYSPARM MODIFY` command, the value specified in the `with-clause` is used for the respective modify operation.
`COMMENT` | Not applicable to the `SYSPARM REPLACE` command. Activates (`ON`) the comment option and writes a comment after each parameter that is modified, or deactivates (`OFF`) the comment option. The default value is `OFF`. If activated, and if no individual comment (see below) has been specified, the comment inserted for each parameter contains the following data: the ID of the user who last modified the parameter profile as generated by the Natural system variable `*USER` and the date and time when the parameter profile was last modified as generated by the Natural system variables `*DATV` and `*TIMX`. (See also the relevant sections in the System Variables documentation.) To modify a comment, use the `REPLACE` keyword of the with-clause.
`character` | Any special character: see the Natural session parameters `ID` (Input Delimiter Character) and `IA` (Input Assign Character) described in the Parameter Reference documentation.
`comment` | A commentary text that is to be placed between the characters `/*` and `*/`.
`profile-name` | The name of a parameter profile or a range of profiles. For a range, you can specify one of the following values where value is any combination of one or more characters:
`value*` | Selects all parameter profiles with names that start with value, for example: `AB*` selects AB and AB1 but not AA1.
`value>` | Selects all parameter profiles with names greater than or equal to value, for example: `AB>` selects AB and AB1 but not AA1.
`value<` | All items with names less than or equal to value, for example: `AX<` selects AB and AWW but not AXA.
Name ranges are only allowed in the `SYSPARM LIST` command, or, in batch mode, the `SYSPARM LIST`, `SYSPARM DISPLAY` and `SYSPARM MODIFY` commands.
`profile-name1` `profile-name2` | Only applies to the `SYSPARM COPY` command. The source parameter profile (profile-name1) from which to create a new parameter profile and the new target parameter profile (profile-name2) into which to copy the data.
`where-clause` | Indicates a where-clause described in the relevant section.
`with-clause` | Indicates a with-clause described in the relevant section.
`TERM1ST` | Only applies in batch mode. Determines whether the Natural session terminates when a SYSPARM error or warning occurs.
`OFF` | The session continues. Any error that occurs is counted as a warning.
`ON` | The session terminates. This is the default.
`WITH return-code` | Specifies the return code to be used when SYSPARM terminates Natural. The valid code range for `return-code` is `0` to `255`. If the `WITH return-code` clause is omitted, a return code of `4` is used by default. If `TERM1ST` is set to `OFF`, a return code of 127 is issued if more than one warning is encountered. This return code is added to the `return-code` specified in the `WITH` clause. For example: a value of `4` (default) then results in a return code of 131.
`RESET` | Resets the warning counter to end the SYSPARM session normally. The warning counter is incremented by one each time a warning is issued when `OFF WITH return-code` is used in the `SYSPARM` command.
If `TERM1ST` is set to `OFF` and more than one warning is encountered, SYSPARM adds a value of 127 to the return code specified in the `WITH return-code` clause, up to the maximum of 255. For example: A value of `4` (default) in the `WITH` clause then results in a final return code of 131.
`...` | Only applies in batch mode. Illustrates that you can specify more than one `SYSPARM` command by placing each command in a separate line.

### where-clause

The where-clause is optional and applies to the keywords `ADD`, `MODIFY`, `DISPLAY`, `LIST`, `DELETE` and `COPY`. Its syntax is as follows:

[`WHERE`] [`DBID` dbid] [`FNR` fnr] [`PASSWORD` password] [`CIPHER` cipher]

The keywords of the where-clause and the variable value that must be supplied with each keyword are explained in the following table:

Keyword | Valid Values
--- | ---
`WHERE` | Optional keyword that indicates the start of a where-clause.
`DBID` | The database ID (dbid) of the Adabas file where the parameter profile is stored.
`FNR` | The file number (fnr) of the Adabas file where the parameter profile is stored.
`PASSWORD` | The 8-character Adabas password (password) of the Adabas file where the parameter profile is stored.
`CIPHER` | The 8-digit cipher code (cipher) of the Adabas file where the parameter profile is stored.

### with-clause

The with-clause is optional and applies to the keywords `ADD`, `MODIFY`, `DISPLAY` and `LIST`. Its syntax is as follows:

[`WITH`] |  |  | `SCAN` `NOSCAN` |  | text |  | `CODEPAGE` `DIRINFO` |  |  |  |  |  |  |  |  |
| `ASSIGN` `DELIMITER` |  | [character] |  |  |  |  |  |  |  |  |
`COMMENT` |  | `ON` `OFF` |  | [comment] |  |  |  |  |  |  |  |
`FIRST` |  | parm-name [parm-value] comment |  |  |  |  |  |  |  |
`LINE` | parm-name=parm-value [parm-name=parm-value] `...`
`LOWER` |  | `ON` `OFF` |  |  |  |  |  |  |  |  |  |  |
`NEW` | parm-name parm-value
`REMOVE` | parm-name
`REPLACE` |  | ;text;text; text text |  |  |  |  |  |  |  |
|  | parm-value |  |  |  |  |  |  |  |  |
`UPDATE` parm-name |  | `ADD` `SUBTRACT` `MAX` `MIN` |  | number |  |  | `ADD` `SUBTRACT` `MAX` `MIN` |  | number |
parm-name`=`parm-value `[`parm-name`=`parm-value`]...`

Notes:

1. In the syntax diagram above, the following only applies to the `ADD` keyword: `[WITH] parm-name=parm-value [parm-name=parm-value]...`
2. In the syntax diagram above, the `LOWER` keyword only applies if used in a `SYSPARM MODIFY` command.

The keywords of the with-clause and the variable value that must be supplied with each keyword are explained in the following table:

Keyword | Valid Values
--- | ---
`WITH` | Optional keyword that indicates the start of a with-clause. Exception: When using the `ADD` keyword, you must also specify the `WITH` keyword to clearly separate the add operation from the contents of the parameter profile.
`SCAN` | Only applies to `SYSPARM LIST` and `SYSPARM DISPLAY` commands. Scans one or more parameter profiles available in the specified Natural system file for a text string (for example, a parameter or a parameter value) and provides a list of the parameter profiles that contain the specified text string.
`NOSCAN` | Only applies to `SYSPARM LIST` and `SYSPARM DISPLAY` commands. Exempts a text string from the scan over one or more parameter profiles available in the current Natural system file and provides a list of the parameter profiles that do not contain the specified text string.
`CODEPAGE` | Only applies to the `SYSPARM LIST` command. The List Profiles screen includes the column Code Page.
`DIRINFO` | Only applies to the `SYSPARM LIST` command. The List Profiles screen includes the columns User ID, Date, Time, Version and Code Page. Note Code page names longer than 17 characters are truncated; see the relevant Note.
`ASSIGN` | See `ASSIGN` in the basic command syntax.
`DELIMITER` | See `DELIMITER` in the basic command syntax.
`LOWER` | See `LOWER` in the basic command syntax.
`COMMENT` | See `COMMENT` in the basic command syntax.
`FIRST` | Moves a parameter and its value or a comment to the first position in a parameter profile. This can be required, for example, if you want to specify the profile parameter `PARM`. Comments contained in the first position of a parameter profile will remain in this position. A parameter and its value will only be moved to the first position if no comment occupies this position. Otherwise, the parameter will be appended after the comment(s). A comment inserted with `FIRST` will always be placed in the first position, before any comment(s) that originally occupied this position.
`LINE` | Only applies to batch commands. Places the specified parameter(s) after `LINE` in a new line at the end of a parameter profile.
`NEW` | Appends a parameter to the end of a parameter profile but not necessarily in a new line. To place a parameter in a new line, use the keyword `LINE`.
`REMOVE` | Removes a parameter and the value assigned (including parentheses) from a parameter profile. The parameter to be removed can be a subparameter, such as the profile parameter `DFS`, which is a subparameter of the profile parameter `RPC`.
`REPLACE` | Replaces an old text string with a new text string contained in a parameter profile. See also the option `COMMENT` in the basic command syntax.
`UPDATE` | Updates the value assigned to a parameter. If the specified parameter does not yet exist, it will be appended to the parameter profile.
`ADD` | Increases the size of a parameter value by adding the specified number. The addition can be limited to a maximum or minimum value by specifying `MAX` or `MIN` (see below).
`SUBTRACT` | Decreases the size of a parameter value by subtracting the specified number. The subtraction can be limited to a maximum or minimum value by specifying `MAX` or `MIN` (see below).
`MAX` | Specifies the maximum of a parameter value.
`MIN` | Specifies the minimum of a parameter value.
`text` | Any text string contained in a parameter profile. The following applies if `SCAN` and `NOSCAN` are used: The text string must not contain any blank characters. The following applies if `REPLACE` is used: If neither the old text nor the new text contains blank characters, place a blank character between old and new text. If the old text or the new text contains blank characters, place the input delimiter character specified between old text and new text and around the entire old/new text string. For example: `;This comment is old;This comment is new;` As an alternative to the specified delimiter character, you can choose any of the following characters:
`'` | an apostrophe
`,` | a comma
`.` | a period
`;` | a semicolon
`/` | a slash
`\` | a back slash
`|` | a vertical bar
`character` | See character in the basic command syntax.
`parm-name` | The full name of a parameter.
`parm-value` | The value assigned to a parameter.
`comment` | See comment in the basic command syntax.
`number` | A numeric value.

### Batch Processing

When processing SYSPARM in batch mode, consider the following:

- To terminate the SYSPARM utility, in a separate line, enter a period (.) or `FIN`, where `FIN` ends the Natural session.

- To terminate a `SYSPARM` command, in a separate line, enter a period (.) or `END`.

- To execute more than one `SYSPARM` command, specify each command in a separate line.

- To extend a command over two lines, enter the character defined with the session parameter `CF` (default is `%`) anywhere in the first line. This indicates continuation on the next line.

See also Example of SYSPARM in Batch.

#### Related Topics:

- Natural in Batch Mode (Operations documentation)

- Using the INPUT Statement in Non-Screen Modes (Statements documentation)

- Using the INPUT Statement in Batch Mode (Statements documentation)

### Example of SYSPARM in Batch

The examples shown in this section demonstrate the use of `SYSPARM` commands and the result of parameter profile modifications executed in batch:

- Example Profile TESTPROF - Before Job Submission
- Example Input
- Example Parameter Profile TESTPROF - After Job Execution
- Example Parameter Profile TESTPRO1 - After Job Execution
- Example of SYSPARM TERM1ST - Command Input
- Example of SYSPARM TERM1ST - Command Output

#### Example Profile TESTPROF - Before Job Submission

    /* This is a test profile. */
    AUTO=ON FNAT = (102,110,PASSWORD) FUSER=(1099,1100,PASSWORD,12345678)
    RPC=(RPCSIZE=80,SRVNAME=MYSERV,SERVER=ON,DFS=(SRV2,NODE1,,ACI))
    PRINT=((2,12,18),AM=STD,DEST='PRINT**',OPEN=INITOBJ,CLOSE=CMD)
    PRINT=((1,3,6-11,15),AM=NAF)
    ESIZE=90

Note
If your current input assign or delimiter character is part of the input, you need to change this input character (see `ASSIGN` or `DELIMITER` in Direct Commands and Batch Processing). This can be done by adding an appropriate `ASSIGN` or `DELIMITER` assignment before the statement that would otherwise cause a runtime error. See the Example Input below.

#### Example Input

    /*JCL
    .
    .
    .
    */
    SYSPARM
    COPY TEST1 TO TESTPROF WHERE DBID 10 FNR 32
    DISP   TESTPROF
    COMMENT ON /* TESTUSER 29.Jan.2009 */
    MODIFY TESTPROF with REM DFS
       REPLACE ;test profile;test profile for SYSPARM in batch;
       NEW BPSIZE 4096
       UPDATE ESIZE  ADD  20  MAX 100
       FIRST PARM INHOUSE
       DELIMITER $
       UPDATE FUSER (,6)
       ASSIGN :
       LINE IM=D, INTENS=1, AUTO=T, MT=0, MADIO=0
       .
    DISP   TESTPROF
    ADD TESTPRO1 WITH /* 106,210 */
        FNAT=(106,210,PASSWORD),FUSER=(,211)
        .
    DISPLAY TESTPRO1
    DELETE  TESTPRO2 WHERE DBID 10 FNR 32
    X TESTPRO3   WHERE DBID 10 FNR 32
    .
    FIN

#### Example Parameter Profile TESTPROF - After Job Execution

    /* This is a test profile for SYSPARM in batch. */
    PARM=INHOUSE /* TESTUSER 29.Jan.2009 */
    AUTO=ON FNAT = (102,110,PASSWORD) FUSER=(,6) /* TESTUSER 29.Jan.2009 */
    RPC=(RPCSIZE=80,SRVNAME=MYSERV,SERVER=ON, )
    PRINT=((2,12,18),AM=STD,DEST='PRINT**',OPEN=INITOBJ,CLOSE=CMD)
    PRINT=((1,3,6-11,15),AM=NAF)
    ESIZE=100 /* TESTUSER 29.Jan.2009 */ BPSIZE=4096 /* TESTUSER 29.Jan.2009
     */
    IM=D, INTENS=1, AUTO=T, MT=0, MADIO=0 /* TESTUSER 29.Jan.2009 */

#### Example Parameter Profile TESTPRO1 - After Job Execution

    /* 106,210 */
    FNAT=(106,210,PASSWORD),FUSER=(,211)

#### Example of SYSPARM TERM1ST - Command Input

    /*JCL
    .
    .
    .
    */
    SYSPARM TERM1ST OFF with 5
      DELETE profile3
      Copy profile1 to profile2
      END
    FIN

#### Example of SYSPARM TERM1ST - Command Output

    NEXT SYSPARM TERM1ST OFF with 5

     Terminating Natural on 1st error is switched OFF.

     Function / Command
     DATA DELETE profile3

     Profile does not exist.

     Function / Command
     DATA Copy profile1 to profile2

     Profile to be copied does not exist.

     Function / Command
     DATA END

     Exit Sysparm, 2 warnings.

     Terminating because TERM1ST OFF WITH is active.

     NAT9987 Natural session terminated abnormally - RC=132.

## Maintaining Profiles in Different Environments

The SYSPARM utility is used to maintain parameter profiles within the same FNAT or FUSER system file.

To transfer parameter profiles (for example, copy or move) between different FNAT and/or FUSER system files, and to perform a parameter profile operation (for example, delete or find) in a different environment, you can use the SYSMAIN utility. For details, see Processing Profiles in the SYSMAIN Utility documentation.

## Invoking Help on Parameters from the Command Line

With the system command `HELP` you can get online help on a parameter or a subparameter. The following commands are available:

`HELP <name>` | Display the help map for parameter name. If there is no such parameter, search is extended to subparameters.
`HELP SUB <name>` | Search for subparameters only. This command is useful if `name` is ambiguous, that is name can refer to both a parameter and a subparameter.
`HELP <prefix>*` | Display a selection list containing matching parameters only. If the string <`prefix`> is left empty, all parameters are displayed.
`HELP HELP` | Display the categories `ADD-ON`, `DRIVER` and `MAIN` on a separate menu. Select a category to display a list of related parameters. You can then select a parameter from this list to view the corresponding help map.
`HELP <category>` | List all parameters related to a category from above.

For further instructions on how to use a help screen invoked this way, see Help with Parameters.

### On this page

- Invoking SYSPARM
- List Profiles
- Display Profile
- Add New Profile
- Modify Profile
- Editing Profiles
- Copy Profile
- Delete Profile
- Direct Commands and Batch Processing
- Maintaining Profiles in Different Environments
- Invoking Help on Parameters from the Command Line