SARSAM Routines

This section includes information about the SARSAM routines used to access the database:
view122
This section includes information about the SARSAM routines used to access the database:
  • SAMOPEN
    The SAMOPEN routine opens the specified database and establishes all the necessary components to access the index and subfile (SYSOUT, panel, or both) data. Only one database can be accessed at one time. Any database that was subsequently opened is automatically closed before the new database is opened.
  • SAMCLOSE
    The SAMCLOSE routine closes a previously opened database, frees all buffers, and frees all storage that is obtained to process data in the database.
  • SAMGET
    The SAMGET routine searches the database for a qualifying index record and returns it into user storage.
  • SAMINVL
    The SAMINVL routine causes all buffered index data to be ignored and causes physical reads of index data to occur on the next access of the database. Because the database can be concurrently updated by any number of users, the started task buffered index data can be incorrect or outdated.
  • SAMMSG
    The SAMMSG routine returns an informational or error message to user storage. This message describes the result of the previously-invoked SAM routine. If the previously- invoked SAM routine had a successful return code, the message returned is blanks.
  • SAMSOPN
    The SAMSOPN routine opens a subfile for processing. A subfile is data that is chained off the index record (SYSOUT data or panel data). Any subfile that was subsequently opened is automatically closed before opening the new subfile.
  • SAMSGET
    The SAMSGET routine reads and returns the next subfile record into user storage.
  • SAMSCLS
    The SAMSCLS routine completes processing of the subfile data, frees all buffers, and frees all storage that is related to processing of the subfile.
  • SAMAOPN
    The SAMAOPN routine opens an auxiliary subfile for processing. An auxiliary subfile contains the SYSOUT indexing data that are generated for an archived SYSOUT. Any subfile that was subsequently opened is automatically closed before opening the new subfile.
  • SAMAGET
    The SAMAGET routine reads and returns the next auxiliary subfile record into user storage.
  • SAMACLS
    The SAMACLS routine completes processing of the auxiliary subfile data, frees all buffers, and frees all storage that is related to processing of the auxiliary subfile.
  • SAMDFMT
    The SAMDFMT routine converts a date from an internal format to a printable format based on the
    View
    standard date format. The internal date formats that are maintained in the database index records are either an unsigned packed Gregorian date or a packed Julian date. In the database index records, date fields are designated as YYYYMMDD or 0CYYDDD, which represent a Gregorian date or Julian date format, respectively.
  • SAMTFMT
    The SAMTFMT routine converts a time from an internal format to a printable format. The internal time formats maintained in the database index records are either an unsigned packed time or a binary time. In the database index records, time fields are designated as 00HHMMSS or BINARY-1/100 SEC, which represent an unsigned, packed time or binary time, respectively.
  • SARSAM
    The SARSAM routine provides an alternate, centralized method for calling the subroutines that are supported by the SARSAM access method. The SARSAM routine itself simply invokes the appropriate subroutine.
  • SARSAM1
    SARSAM1 is a demonstration program that describes how to use SARSAM to retrieve database control records. The control cards can be used to determine what records are formatted for printing.
  • SARSAM2
    SARSAM2 is a demonstration program that describes how to use the
    View
    Database Access Method (SARSAM) to retrieve information from the database. This sample can find the SYSOUTs on a tape or range of tapes. SARSAM2 optionally generates /DELETE cards for reports on TAPE and /CHANGE cards for reports still on DISK. These generated control cards can be used as input to SARBCH to make updates to the database.
  • SARSAM3
    SARSAM3 is a demonstration program that describes how to use the
    View
    Database Access Method (SARSAM) to retrieve information from the database. This sample can list ACIF resource information in the
    View
    database.
  • SARSAM4
    SARSAM4 is a demonstration program that describes how to use the
    View
    Database Access Method (SARSAM) to retrieve information from the database. This sample can list the Tape Control Record information. Optionally, it can display a specific tape or a range of tapes.
  • SARSAM5
    SARSAM5 is a demonstration program that shows you how to use the
    View
    Database Access Method (SARSAM) to retrieve information from the database. This sample lists GCR records and compares the line count to the amount of data in the subfile. The code verifies that the GCR line count matches the report saved in the database.
  • SARSAM6
    SARSAM6 is a demonstration program that shows you how to use the
    View
    Database Access Method (SARSAM) to retrieve information from the database. This sample can list the GCR Record information and optionally write /DELETE control cards for the GCR data. These /DELETE can be used as input to SARBCH to delete the GCR data.
  • SARSAM7
    SARSAM7 is a demonstration program that shows you how to use the
    View
    Database Access Method (SARSAM) to retrieve information from the database. This sample can search the database and can find specific index entries and build /PRINT control cards. The /PRINT are used as input to SARBCH to print the information found during the search.
  • SARSAM8
    ADLIST is a demonstration program that shows you how you can use SARSAM,
    View
    's database access method, to retrieve specialized information from the database control records.
  • SARSAM9
    DBFIND is a demonstration program that shows you how you can use
    View
    's Database Access Method (SARSAM) to retrieve specialized information from the database. This sample can find character strings within the sysout data records of the specified reports.
  • SARSAMA
    ANNORPT is a demonstration program that was written to show you how you can use
    View
    's Database Access Method (SARSAM) to retrieve specialized information from the database.
  • SARSAMB
    SARSAMB is a demonstration program that describes how to use the
    View
    Database Access Method (SARSAM) to retrieve information from the database. This sample can list all GCR records with a report ID=UNDEF. Optional command FROMDATE(MM/DD/YYY) lets you list only reports that were archived on or after this date.