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:

Related Topic:

  • PROFILE in the Parameter Reference documentation


Invoking SYSPARM

Beginn der Anweisungsliste 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.

Beginn der Anweisungsliste 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).

    Anmerkung:
    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.

Beginn der AnweisungslisteTo 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.

    Oder:
    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.

Beginn der AnweisungslisteTo 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.

Beginn der Anweisungsliste To display a parameter profile

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

    Oder:
    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.

Beginn der Anweisungsliste 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.

Beginn der Anweisungsliste To modify a parameter profile

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

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

    Oder:
    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

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.

Beginn der Anweisungsliste 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.

    Oder:
    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.

Copy Profile

This function is used to copy parameter profiles.

Beginn der Anweisungsliste 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.

Beginn der Anweisungsliste 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.

    Oder:
    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

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.

Anmerkung:
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.

Anmerkung:
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

             

../graphics/cbc25.gif

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]...

Anmerkungen:

  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.

Anmerkung:
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:

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

/* 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

Anmerkung:
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.