Special variables for use with the ISFLOG command

There are a number of special variables that you can use with the ISFLOG command. For information on special REXX variables, see Using special variables to invoke SDSF function and Special variables reference.

Several of the special variables provide function that corresponds to scrolling through the data. For example, you might specify a number of lines that you want to retrieve with each browse request, using ISFLINELIM, then use logic and other special variables to advance through the data, as shown below:

isflinelim = 500                                
   do until isfnextlinetoken=''                    
      Address SDSF "ISFLOG READ TYPE(SYSLOG)"
      /****************************/             
      /* Loop through the lines    /             
      /****************************/             
      do ix=1 to isfline.0                           
        say isfline.ix                                
      end                                            
   isfstartlinetoken = isfnextlinetoken                                  
end

Use these special variables with the ISFLOG command:

ISFCOLOR: is a stem variable containing a single-character abbreviation for the color for each line. The possible values come from first letter of these colors: Red, Green, Blue, White, Yellow, Turquoise, Pink. OPERLOG only.
ISFDATE: specifies the date format, including the separator character, for special variables that take a date as input. It accepts any format valid with the SET DATE command. See the SET DATE command in the online help for the valid formats.
ISFDESCODE: is a stem variable containing the descriptor codes for each line. When there are multiple descriptor codes, they are turned in a list, separated by blanks. OPERLOG only.
ISFFIRSTLINEDATE: is the date associated with the first line that was returned.
ISFFIRSTLINEDSID: is the data set identifier of the data set associated with the first line that was returned. SYSLOG only.
ISFFIRSTLINEJOBID: is the job ID associated with the first line that was returned. SYSLOG only.
ISFFIRSTLINERECNO: is the record number within the data set of the first line that was returned. SYSLOG only.
ISFFIRSTLINETIME: is the time associated with the first line that was returned.
ISFFIRSTLINETOKEN: is a token corresponding to the first line of the data that was returned.
ISFHIGHLIGHT: is a stem variable containing a single-character abbreviation for the highlighting for each line. The possible values come from the first letter of these highlight values: Blink, Reverse, Underline and None. OPERLOG only.
ISFINTENSITY: is a stem variable containing a single-character abbreviation for the intensity for each line. The possible values come from the first letter of these intensities: High and Low. OPERLOG only.
ISFLASTLINEDATE: is the date associated with the last line that was returned.
ISFLASTLINEDSID: is the data set identifier of the data set associated with the last line that was returned. SYSLOG only.
ISFLASTLINEJOBID: is the job ID associated with the last line that was returned. SYSLOG only.
ISFLASTLINERECNO: is the record number within the data set of the last line that was returned. SYSLOG only.
ISFLASTLINETIME: is the time associated with the last line that was returned.
ISFLINE: contains the data that is returned. It is a stem variable. ISFLINE.0 contains the number of variables.
ISFLINELIM: limits the number of ISFLINE stem variables that may be created. The valid values are 0-99999999. A value of zero indicates no limit.
ISFLOGSTARTDATE: specifies the starting date for records returned by the ISFLOG command, in the current date format (see the ISFDATE special variable) or yyyy.ddd. Leading zeros are not required. It must be less than the ending date. The default is the current day. Due to the precision of these fields, positioning within the log will be approximate.
ISFLOGSTARTTIME: specifies the starting time for records returned by the ISFLOG command, in hh:mm:ss.th format. Only hh:mm is required. Leading zeros are not required. This is the local time corresponding to the first record to be returned. It must be less than the ending time. The default is 00:00:00.00. Due to the precision of these fields, positioning within the log will be approximate.
ISFLOGSTOPDATE: specifies the ending date for records returned by the ISFLOG command, in the current date format (see the ISFDATE special variable) or yyyy.ddd. Leading zeros are not required. The default is the current day. Due to the precision of these fields, positioning within the log will be approximate.
ISFLOGSTOPTIME: specifies the ending time for records returned by the ISFLOG command, in hh:mm:ss.th format. Only hh:mm is required. Leading zeros are not required. This is the local time corresponding to the last record to be returned. The default is 23:59:59.99. Due to the precision of these fields, positioning within the log will be approximate.
ISFNEXTLINETOKEN: is a token corresponding to the next unread line of the data that was returned. It is null when an end-of-file condition is encountered.
ISFSTARTLINETOKEN: specifies the starting line for the data to be returned. Assign a value by setting the variable to either the ISFFIRSTLINETOKEN or ISFNEXTLINETOKEN special variable.
ISFSYSID: with the SYSLOG, names the member to be processed by the ISFLOG command. See the SYSID command in the online help.
ISFWTOR: is a stem variable that contains the WTORs, if requested with the WTOR option. ISFWTOR.0 contains the number of variables.

Use these special variables with the ISFLOG command for find and scroll functions:

ISFFIND

contains a string to be found, up to 255 characters. The find operation is not sensitive to case. Use this with a value of FINDNEXT or FINDPREV in the ISFSCROLLTYPE special variable.

ISFFINDENDCOL

specifies the column by which the string specified with the ISFFIND special variable must end. It must be less than ISFFINDSTARTCOL.

ISFFINDLIM

specifies the maximum number of lines to search for the string specified with the ISFFIND special variable. Valid values are 1000 through 9999999.

ISFFINDSTARTCOL

specifies the column in which the string specified with the ISFFIND special variable must start.

ISFSCROLL

is used to reposition the first line of data that is returned. Specify an integer to be used as an offset from the value in the ISFSTARTLINETOKEN special variable. Then, specify a value of UP or DOWN for the ISFSCROLLTYPE special variable. If ISFSTARTLINETOKEN is not specified, the offset is applied to the top of the data set.

ISFSCROLLTYPE

is used to reposition the first line of data that is returned. Specify one of these values:

UP or DOWN: is used with the value in the ISFSCROLL special variable. DOWN is the default.
TOP: specifies that the first record returned is the first record of the data. This is the default.
BOT: requests the bottom, or most recent, data. The last line returned is the last line of data. The first line returned is a function of the value of the ISFLINELIM special variable. For example, if you use BOT with a value of 100 for ISFLINELIM, the last 100 lines of data are returned.
FINDNEXT: is used with the value in the ISFFIND special variable to reposition to the next line that contains that string. If the ISFSTARTLINETOKEN special variable is not specified, the search begins with the top line.
FINDPREV: is used with the value in the ISFFIND special variable to reposition to the previous line that contains that string. If the ISFSTARTLINETOKEN special variable is not specified, the search begins with the top line, wraps to the bottom and then searches from there.