Files Installed on Your System

 

This chapter describes the files in each of the following MVS Client datasets:

• DMQ.V5R0.CNTL Dataset: JCL Files

• DMQ.V5R0.H Dataset: Include Files

• DMQ.V5R0.X Dataset: Sample Programs

• DMQ.V5R0.COB Dataset: COBOL Sample Programs and Copy Books

• DMQ.V5R0.LIB Dataset: Callable Library Support for Batch and CICS 4.1

• DMQ.V5R0.PROC Dataset: Example Programs

DMQ.V5R0.CNTL Dataset: JCL Files

The DMQ.V5R0.CNTL dataset contains the JCL files listed in Table 2-1.

Table 2-1 MVS JCL Files

Member	Contents
DMQCOBOL	Sample JCL to compile, prelink, and linkedit a BEA MessageQ batch COBOL program
DMQCOBCI	Sample JCL to translate, compile, prelink, and linkedit a BEA MessageQ CICS COBOL program
DMQCOMP	Sample JCL to compile batch BEA MessageQ C applications
DMQCICS	Sample JCL to linkedit a sample C CICS program
DMQCONF	JCL code that creates and initializes the initialization file
DMQELOG	JCL code that creates and initializes the log file
DMQINST	JCL code that installs the BEA MessageQ MVS Client
DMQJRNL	JCL code that creates the Store and Forward file
DMQLINK	Sample JCL to prelink and linkedit C batch applications using the batch and CICS 4.1 library
DMQLOG	JCL code that creates and initializes the BEA MessageQ message log file
DMQRUN	JCL code that runs a BEA MessageQ client application program
DMQSAMP	Sample JCL to compile, prelink, linkedit, and run a batch C program
DMQSAFD	JCL code that prints the contents of the store and forward file

Listing 2-1 shows the ISPF panel, Data Set Information, that describes the dataset organization and space requirements of DMQ.V5R0.CNTL.

Listing 2-1 ISPF Panel Data Set Information for DMQ.V5R0.CNTL

---

 Data Set Name  . . . : DMQ.V5R0.CNTL
  
 General Data                          Current Allocation
  Volume serial . . . : TSO001          Allocated tracks  . : 10
  Device type . . . . : 3380            Allocated extents . : 1
  Organization  . . . : PO              Maximum dir. blocks : 2
  Record format . . . : FB
  Record length . . . : 80
  Block size  . . . . : 6160           Current Utilization
  1st extent tracks . : 10              Used tracks . . . . : 2
  Secondary tracks  . : 2               Used extents  . . . : 1
                                        Used dir. blocks  . : 1
  Creation date . . . : 1998/12/15      Number of members . : 13
  Referenced date . . : 1998/12/15
  Expiration date . . : ***None***

---

DMQ.V5R0.H Dataset: Include Files

The DMQ.V5R0.H dataset contains the C language include files listed in Table 2-2.

Table 2-2 C Language Include Files

Member	Contents
P@ENTRY	Function prototypes and type declarations for the BEA MessageQ API
P@RETURN	Return status values
P@SYMBOL	Symbolic constants used for function parameters
P@PROCES	Constant definitions for BEA MessageQ (for OpenVMS) processes
P@GROUP	Constant definitions for BEA MessageQ message-based services
P@MSG	PAMS message API definitions
P@STATUS	PAMS status-to-text conversion
P@TYPECL	Constant definitions of BEA MessageQ message type and class for message-based services

Listing 2-2 shows the ISPF panel, Data Set Information, that describes the dataset organization and space requirements of DMQ.V5R0.H.

Listing 2-2 ISPF Panel Data Set Information for DMQ.V5R0.H

---

Data Set Name  . . . : DMQ.V5R0.H
 
 General Data                          Current Allocation
  Volume serial . . . : TSO001          Allocated tracks  . : 10
  Device type . . . . : 3380            Allocated extents . : 1
  Organization  . . . : PO              Maximum dir. blocks : 2
  Record format . . . : VB
  Record length . . . : 259
  Block size  . . . . : 6160           Current Utilization
  1st extent tracks . : 10              Used tracks . . . . : 1
  Secondary tracks  . : 2               Used extents  . . . : 1
                                        Used dir. blocks  . : 1
  Creation date . . . : 1998/12/15      Number of members . : 0
  Referenced date . . : 1998/12/15
  Expiration date . . : ***None***
 

---

DMQ.V5R0.X Dataset: Sample Programs

The DMQ.V5R0.X dataset contains the sample C source files listed in Table 2-3.

Table 2-3 Sample C Source Files

Member	Contents: Sample Program for . . .
X@ATTNAM	Attaching by name
X@ATTNUM	Attaching by number
X@ATTTMP	Attaching to a temporary queue
X@AVAIL	Avail/unavail
X@BASIC	Performing a basic put/get to self
X@BIND	Binding to a queue
X@EXIT	Exiting a queue
X@GET	Getting a message in a queue
X@GETALL	Getting all messages in a queue
X@GETEM	Getting messages by class and type
X@GETPRI	Getting messages by priority
X@GETSEL	Getting messages with a selection filter
X@GETSHO	Getting messages with show buffer
X@LOCATE	Locating a queue
X@PUTBIG	Putting a large message on a queue
X@PUTSLF	Putting a message to self
X@RECOVR	Putting a message to a recovery journal
X@SBSDER	SBS deregister
X@SBSREG	SBS register
X@SBSREZ	SBS register EZ
X@SBSTAT	SBS status
X@SDM	A self describing message
X@SELECT	Setting select messages
X@SHOPND	Showing pending messages
X@TIMER	A timer message

Listing 2-3 shows the ISPF panel, Data Set Information, that describes the dataset organization and space requirements of DMQ.V5R0.X.

Listing 2-3 ISPF Panel Data Set Information for DMQ.V5R0.X

---

Data Set Name  . . . : DMQ.V5R0.X
 
 General Data                          Current Allocation
  Volume serial . . . : TSO001          Allocated tracks  . : 20
  Device type . . . . : 3380            Allocated extents . : 1
  Organization  . . . : PO              Maximum dir. blocks : 5
  Record format . . . : VB
  Record length . . . : 259
  Block size  . . . . : 6160           Current Utilization
  1st extent tracks . : 20              Used tracks . . . . : 1
  Secondary tracks  . : 10              Used extents  . . . : 1
                                        Used dir. blocks  . : 1
  Creation date . . . : 1998/12/15      Number of members . : 0
  Referenced date . . : ***None***
  Expiration date . . : ***None***
 

---

DMQ.V5R0.COB Dataset: COBOL Sample Programs and Copy Books

The DMQ.V5R0.COB dataset contains the sample COBOL programs and Copy Books listed in Table 2-4.

Table 2-4 Sample COBOL Source Files and Copy Books

Member	File Type	Contents
DMQCLASS	Copy	Definitions of Message Classes and Message Types
DMQGROUP	Copy	Definitions of message-based services
DMQPCESS	Copy	Definitions of message queues
DMQRC	Copy	Definitions of return codes
DMQSAMP1	Source	Sample COBOL batch program
ZDMQPROG	Source	Sample COBOL CICS program

Listing 2-4 shows the ISPF panel, Data Set Information, that describes the dataset organization and space requirements of DMQ.V5R0.COB.

Listing 2-4 ISPF Panel Data Set Information for DMQ.V5R0.COB

---

 Data Set Name  . . . : DMQ.V5R0.COB
 
 General Data                          Current Allocation
  Volume serial . . . : TSO001          Allocated tracks  . : 10
  Device type . . . . : 3380            Allocated extents . : 1
  Organization  . . . : PO              Maximum dir. blocks : 2
  Record format . . . : FB
  Record length . . . : 80
  Block size  . . . . : 6160           Current Utilization
  1st extent tracks . : 10              Used tracks . . . . : 5
  Secondary tracks  . : 2               Used extents  . . . : 1
                                        Used dir. blocks  . : 1
  Creation date . . . : 1998/12/15      Number of members . : 6
  Referenced date . . : 1998/12/15
  Expiration date . . : ***None***

---

DMQ.V5R0.LIB Dataset: Callable Library Support for Batch and CICS 4.1

The DMQ.V5R0.LIB dataset contains the object library for Language Environment Batch and CICS, Version 4.1. Table 2-5 lists the contents of the DMQ.V5R0.LIB dataset.

.

Table 2-5 MVS Callable Reference Files

Member	File Type
AVL@TREE	Object
CL@API	Object
CL@ASCEB	Object
CL@BIND	Object
CL@INI	Object
CL@MEM	Object
CL@MPP	Object
CL@MSG	Object
CL@PUTL	Object
CL@SERV	Object
CL@TRACE	Object
CL@WLOG	Object
CLMVSJRN	Object
CLMVSSPI	Object
CLNOCICS	Object
DAP	Object
DAP@BUFF	Object
DAP@DTS	Object
DAP@INIT	Object
IO@MISC	Object
IOMVSF	Object
NIO@OBJE	Object
NIO@STUB	Object
NIO@TCPI	Object
PAMS@SDM	Object
PAMS@SEL	Object
PAMS@STA	Object
SDM@BUFF	Object
SDM@CONT	Object
SDM@HAND	Object
SDM@MISC	Object
SDM@TRAC	Object
SPI@GENE	Object
SPI@TIME	Object
SPI@XDR	Object
X@ATTNAM	Object
X@ATTNUM	Object
X@ATTTMP	Object
X@AVAIL	Object
X@BASIC	Object
X@BIND	Object
X@EXIT	Object
X@GET	Object
X@GETALL	Object
X@GETEM	Object
X@GETPRI	Object
X@GETSEL	Object
X@GETSHO	Object
X@LOCATE	Object
X@PUTBIG	Object
X@PUTSLF	Object
X@RECOVR	Object
X@SBSDER	Object
X@SBSREG	Object
X@SBSREZ	Object
X@SBSTAT	Object
X@SDM	Object
X@SELECT	Object
X@SHOPND	Object
X@TIMER	Object

Listing 2-5 shows the ISPF panel, Data Set Information, that describes the dataset organization and space requirements of DMQ.V5R0.LIB.

Listing 2-5 ISPF Panel Data Set Information for DMQ.V5R0.LIB

---

Data Set Name  . . . : DMQ.V5R0.LIB
 
 General Data                          Current Allocation
  Volume serial . . . : TSO001          Allocated tracks  . : 100
  Device type . . . . : 3380            Allocated extents . : 1
  Organization  . . . : PO              Maximum dir. blocks : 5
  Record format . . . : FB
  Record length . . . : 80
  Block size  . . . . : 6160           Current Utilization
  1st extent tracks . : 100             Used tracks . . . . : 31
  Secondary tracks  . : 10              Used extents  . . . : 1
                                        Used dir. blocks  . : 3
  Creation date . . . : 1998/12/15      Number of members . : 62
  Referenced date . . : 1998/12/15
  Expiration date . . : ***None***

---

DMQ.V5R0.PROC Dataset: Example Programs

The DMQ.V5R0.PROC dataset contains the example programs listed in Table 2-6.

Table 2-6 Example Programs

BEA MessageQ Example Programs	Member Type	Description
X@BASIC	MVS/TSO proc	Illustrates the four basic BEA MessageQ calls: attach, put, get, and exit.
X@GET	MVS/TSO proc	Highlights the pams_get_msg API with selection by message class and type.

Listing 2-6 shows the ISPF panel, Data Set Information, that describes the dataset organization and space requirements of DMQ.V5R0.PROC.

Listing 2-6 ISPF Panel Data Set Information for DMQ.V5R0.PROC

---

Data Set Name  . . . : DMQ.V5R0.PROC
 
 General Data                          Current Allocation
  Volume serial . . . : TSO001          Allocated tracks  . : 100
  Device type . . . . : 3380            Allocated extents . : 1
  Organization  . . . : PO              Maximum dir. blocks : 5
  Record format . . . : FB
  Record length . . . : 80
  Block size  . . . . : 6160           Current Utilization
  1st extent tracks . : 100             Used tracks . . . . : 26
  Secondary tracks  . : 10              Used extents  . . . : 1
                                        Used dir. blocks  . : 1
  Creation date . . . : 1998/12/15      Number of members . : 2
  Referenced date . . : 1998/12/15
  Expiration date . . : ***None***

---