Re: SPCLVAL & SNGVAL Parameter

[Pete Hall <peteh@xxxxxxxxxx>]

At 15:14 07/15/98 +0700, Ivan Martinus wrote:
>I'm a beginner to CL programming. I've seen several program on magazine
>using SPCLVAL or SNGVAL parameter on the CMD file.
>I have look at the IBM Redbooks but cannot get a clear understanding of
>the definition and usage of those two paramater comparing to DFT value
>or by just using VALUES.

SPCVAL defines pairs of values. The first is what the user can key into the 
parameter. It doesn't necessarily need to conform to the validity checking 
rules. It is not even required to match the parameter's data type. It is a 
string (character) value. The second value is the value that is passed to the 
command processor when the first value is specified. For instance, you might 
specify:

   SPCVAL((*first 1) (*second 2) (*third 3))

If the user specifies *second, the command will pass the numeral 2 (or the 
number, depending on the data type of the parameter).

SNGVAL is what the user can specify in place of a list of values (or a 
qualified name). A good example is the SIZE parameter of the CHGPF command. 
This parameter is actually a list of three values, the size, the increment, and 
the number of increments. You can specify SIZE(10000 1000 3) to create a file 
with members that will hold 10000 records, and will increase in size in 1000 
byte increments for a total of three times, or if you would like, you can 
specify SIZE(*NOMAX). The value *NOMAX is a SNGVAL. It is specified just like 
SPCVAL as a pair of values SNGVAL(*NOMAX -1). The command processing program 
can check the first value in the list and ignore the rest of -1 is found.

hth
Pete

Pete Hall
peteh@inwave.com 
http://www.inwave.com/~peteh/

+---
| This is the Midrange System Mailing List!
| To submit a new message, send your mail to MIDRANGE-L@midrange.com.
| To subscribe to this list send email to MIDRANGE-L-SUB@midrange.com.
| To unsubscribe from this list send email to MIDRANGE-L-UNSUB@midrange.com.
| Questions should be directed to the list owner/operator: david@midrange.com
+---