Communications/Transactions Guide and Reference
Use the MQ Series Proc Dialog - Settings window to change the attributes of
a MQ Series Proc Dialog.
Use the Destination tab to specify the
information necessary to access a MQ Series network.
- Queue manager name
- In the Queue manager name field, type the name of the queue
manager that you want to read and write to. The maximum length is 48
characters.
- Request Queue name
- In the Request Queue name field, type the name of the message
queue that is used to send requests from the client to the server. If
you have selected the Server check box, this message queue is the
input queue. If you have not selected the Server check box,
this message queue is the output queue. If you want to use the same
queue for input and output, you can specify the same message queue name in
this field and the Reply Queue name field. The maximum
length for the message queue name is 48 characters.
- Reply Queue name
- In the Reply Queue name field, type the name of the message
queue that is used to send replies from the server to the client. If
you have selected the Server check box, this message queue is the
output queue. If you have not selected the Server check box,
this message queue is the input queue. If you want to use the same
queue for input and output, you can specify the same message queue name in
this field and the Request Queue name field. The maximum
length for the message queue name is 48 characters.
- Alternate userid
- In the Alternate userid field, type the name of the alternate
userid you want to use to check authorization when the queue manager is
opened. You do not have to specify a value in this field. This
userid is used in place of the user ID that the application is currently
running under.
- Sync point processing
- Select Sync point processing to specify that you want sync
point processing performed by the queue manager. Sync point processing
includes commit, rollback, message reads, and message writers within a
LUW.
- Server
- Select Server if your application acts as a server. If
you select Server, the message queue specified in Request
Queue name field is the input queue used to receive client requests, and
the message queue specified in Reply Queue name is the output queue
used to send replies to clients.
If you do not select Server, the message queue specified in
Request Queue name field is the output queue used to send requests
to the server, and the message queue specified in Reply Queue name
is the input queue used to receive server replies.
Use the Data Attributes tab to specify
program initialization parameters and data handling options for a
conversation:
- Code page
- In the Code page field, type the character code page used by
the remote system. The default code page is whatever the current code
page is for the system you are developing your application on.
- Buffer length
- In the Buffer length field, type the size of the memory buffer
VisualAge should allocate for the data sent to and received from the
server. For a remote external function call, the buffer size must be at
least as large as the total size of the record used by the function.
The default value for this field is 1024.
- Big endian
- Select Big endian to specify you want the partner to use the
bigEndian format. If you do not select Big endian, the
partner uses littleEndian format.
Use the Records tab to specify the record
that will be passed to the function on the server. When VisualAge calls
the remote function, it can pass the program a record containing input and
output fields. When the function completes, any output fields are
filled in with the function's output values.
If the remote function does not require a record, you can leave this page
blank.
- Function language
- Under Function language, select the type (C or COBOL) for the
record to be passed.
- File name
- In the File name field, type the name of the C header file or
COBOL copybook file declaring the data types or records used by the external
function. To list the available files, select Find.
To view the contents of a file, select View. When you have
specified the file you want to use, select Parse.
- Parse
- Select Parse to have VisualAge read the C header file or COBOL
copybook file and build a list of records. From the list, you can
manually build the parameter list to use with the external function.
The records (or potential parameters) appear in the Available
list. The parameters you select appear on the external function
part's public interface. Then, other parts can set or retrieve the
values contained in the records.
- Parameter word size
- Under Parameter word size, select the word size used for system
dependent data types (16 bit or 32 bit). This
setting is not available on UNIX systems.
- Available records
- The Available records list shows all of the record formats, or
data types, defined in the file specified in the File to Parse
field.
If you are working with a C External Function, for a C header file, these
are all of the data types declared with typedef or
struct. If you are working with a COBOL External Function,
for a COBOL copybook file, these are the record formats declared by 01-level
and 77-level declarations. The items specified in the PROCEDURE
DIVISION USING statement or "ENTRY" statement should compose the list of the
To be passed.
Tasks
- Alignment Under Alignment, change the selection from 1 if
firelds must be aligned on byte boundaries. Possible values are 1,2,4,
and 8.
- Communicating Over Networks
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]