Service Group Application Reference

Back Next

Parameters

The parameters used to Call the

BROWSE

Service are:

No.	Name	Size (bytes)	Filled in by
1	Service name	8	Application
2	Response code	2	BROWSE
3	Function	1	Application
4	Algorithm Name	1	Application
5	Screen	4804	BROWSE
6	Work-area	100,000 (minimum)	BROWSE

SERVICE-NAME (8/32 bytes): The name of the Service for the BROWSE service type as it has been defined in the Service Group Definition. The supplied Fast-start Service Group definitions simply use the name BROWSE.

RESPONSE-CODE (2 bytes): This parameter is filled in by the Service to indicate the success or otherwise of the Call, a value of "
00
" indicates that all was well, any other value flags a warning or an error. An extended response code is also returned in the Work Area, described below. For a description on how to check Response Codes, turn to the
How an Application Should Test the Response Code
section.

FUNCTION (1 byte): The following functions are supported:; Function 1 - Generates a listing of the Service Group and Algorithm, including authorization signatures.
Function 2 - Generates a detailed listing of the Service Group, all Algorithms, Function definitions, Customset definitions, Account Rules definitions, Services, modules, signatures, Matching Schemes and Matching Methods.
Function 3 - Generates for one Algorithm, a detailed list of its Function definitions, Customset definitions, Account Rules definitions, Services, modules and signatures.
Function 4 - Generates a listing of the Edit-list for an Algorithm.
Function 5 - Generates a detailed list of the Matching Schemes and Methods.
Function 6 - Generates a hex dump of the Frequency Table associated with a particular Algorithm. This can be used for migrating a frequency table from MVS to a PC environment. Refer to the
Utilities/ Migrating a Frequency Table
section of the
GENERATION and TESTING GUIDE FOR SSA-NAME3 SERVICE GROUPS
for details.

ALGORITHM (8 bytes): The
Algorithm
parameter should identify the name of the Algorithm for which you want to generate the internal report, for example PERSON.

SCREEN (4804 bytes): The Screen parameter has two fields:

PAGE-NO 4 bytes
DATA-LINES 4800 bytes; The first four bytes are a page number (must be four numeric characters). The next 4800 characters are the report structured as 60 lines of 80 characters.

You set
SSA-PAGE
to a page number and the result will contain that page. If the result has a page of ’0000’ then there is no such page available (probably you reached the end of the data).

Function ’1’ returns only page ’0001’, so this is what you will specify.