![]() |
![]() |
Important: IBM VisualAge PL/I 2.1.7 requires IBM Foreign File System PTF IP22114. If you do not already have IBM Foreign File System installed from another product (such as IBM VisualAge COBOL 3.0.0), then follow the instructions in this document to install and configure the base product. Then install PTF IP22114, which is included on this CD. If you have already installed and configured the base IBM Foreign File System product, then you only need to install PTF IP22114. For information on installing PTF IP22114, see Installing PTF IP22114.
When developers use VisualAge PL/I to edit, compile, or debug files that are on OS/390, communications between the workstation and OS/390 are through Transmission Control Protocol/Internet Protocol (TCP/IP). In addition, VisualAge PL/I relies on four servers:
The foreign file system server communicates between the workstation and the host through the HTTP protocol. The IBM HTTP Server (formerly Domino Go Webserver) runs under UNIX System Services (formerly Open Edition) in OS/390. The server must be installed under the hierarchical file system (HFS) of UNIX System Services and configured for the remote capability of VisualAge PL/I. This server communicates with the foreign file system server through the GoWebserver API (GWAPI).
Before developers can communicate with the host using TCP/IP, a system programmer must configure the host for remote edit-compile-debug. The general steps are shown in the checklist below.
Step | For details, see: | Done? |
---|---|---|
Make sure that the appropriate
required software and service updates are installed:
|
Installing the prerequisite OS/390 software | |
Install the foreign file system server and job monitor server. | Installing the foreign file system server and job monitor server | |
Configure the IBM HTTP Server. | Configuring the IBM HTTP Server | |
Configure the software for the host
that comes with VisualAge PL/I for Windows NT to support remote
edit-compile-debug:
|
Configuring the foreign file system server | |
Install and configure the TSO commands server (optional) to support issuing TSO commands from the workstation. | Installing and configuring the TSO commands server (optional) | |
Configure Debug Tool for remote debugging under CICS. | Configuring OS/390 for remote debugging under CICS | |
Test the connections. |
RELATED REFERENCES
TCP/IP
V3R2 for MVS: Customization and Administration, SC31-7134
TCP/IP
V3R2 for MVS Bookshelf
IBM
HTTP Server: Planning, Installing, and Using, SC31-8690
Before you configure communications for remote editing, compiling, and debugging using IBM VisualAge PL/I for Windows NT, Version 2.1.7 Refresh, you must install the following software
The program directory provided with any of these host products details the installation process using SMP/E RECEIVE, APPLY, and ACCEPT commands. It also gives up-to-date service information, including PTFs or APARs that you need to apply.
Because of a defect caused by DB2 UDB for OS/390 Version 6.1 and later, programmers cannot use mixed SBCS and DBCS data in the REMARKS column of an OS/390 DB2 stored procedure definition. To enable this use, you need to update the FOREIGNKEY column for the SYSIBM.SYSROUTINES table as follows:
UPDATE SYSIBM.SYSCOLUMNS SET FOREIGNKEY=' ' WHERE TBNAME = 'SYSROUTINES' and NAME='REMARKS';
For remote edit-compile-debug, the workstation must have Windows NT 4.0 with Service Pack 4 or later, in addition to IBM VisualAge PL/I Version 2.1.7 Refresh for Windows NT (5801-AAR).
RELATED TASKS
Configuring OS/390 for remote ECD: overview
IBM
HTTP Server: Planning, Installing, and Using, SC31-8690
IBM
HTTP Server Troubleshooting Guide
Domino
Go Release 5.0 Webmaster's Guide, SC31-8691
OS/390:
Planning for Installation, GC28-1726
This material is intended for the system programmer responsible for installing and maintaining programs. It contains information concerning the material and procedures associated with the installation of the OS/390 components of the VisualAge PL/I for NT V2.1.7 Refresh. You should read all of this material before installing the OS/390 components and then keep it for future reference.
The material contains the following sections:
Before installing VA PL/I V2.1.7, read Preventive service planning. This section tells you how to find any updates to the information and procedures in this chapter.
VA PL/I V2.1.7 has two major OS/390 components:
Both the client portion and the server portion of these components are available with VisualAge PL/I for NT V2.1.7.
VA PL/I V2.1.7 consists of the following FMID:
HFBN100
An IBM program is identified by a program number and a feature number. The program number for VA PL/I V2.1.7 is 5655-B22.
Basic machine-readable materials are materials that are supplied under the base license and feature code, and are required for the use of the product. Optional machine-readable materials are orderable under separate feature codes, and are not required for the product to function.
The OS/390 components of VisualAge PL/I are distributed on the same CD-ROM as the workstation component. The OS/390 components are provided on the CD-ROM in a format that can be uploaded to the OS/390, expanded into SMP/E RELFILE format, then installed using SMP/E. See Installation instructions for more information about how to install the program.
The following table describes the OS/390 file content of the CD-ROM:
Directory | Name | Description |
---|---|---|
Hfbn100 | FBN.IBM.HFBN100.SEQ5JCL | Sample job to allocate sequential data sets on the OS/390 for the compressed RELFILEs and SMPMCS |
Hfbn100 | FBN.IBM.HFBN100.F1.BIN | RELFILE in compressed form |
Hfbn100 | FBN.IBM.HFBN100.F2.BIN | RELFILE in compressed form |
Hfbn100 | FBN.IBM.HFBN100.F3.BIN | RELFILE in compressed form |
Hfbn100 | FBN.IBM.HFBN100.F4.BIN | RELFILE in compressed form |
Hfbn100 | FBN.IBM.HFBN100.SMPMCS | SMPMCS file |
No optional machine-readable materials are provided for VA PL/I V2.1.7.
This section describes the IBM support available for VA PL/I V2.1.7.
Contact your IBM representative for specific information about available program services.
Before installing VA PL/I V2.1.7, you should review the current preventive service planning (PSP) information. Contact the IBM Support Center or use S/390 SoftwareXcel to obtain the current PSP bucket.
PSP buckets are identified by upgrades, which specify product levels, and subsets, which specify the FMIDs for a product level. The subset value for VA PL/I V2.1.7 is HFBN100. Check the VisualAge PL/I Web site (http://www-4.ibm.com/software/ad/pli/) for the upgrade value.
Report any difficulties you have using this program to your IBM Support Center. If an APAR is required, the Support Center will provide the address to which any needed documentation can be sent.
The following table identifies the component IDs (COMPID) for VA PL/I V2.1.7:
FMID | COMPID | Component name | RETAIN release |
---|---|---|---|
HFBN100 | 5639I4402 | Foreign File System 1.0.0 | 100 |
This section identifies the program and any relevant service levels of VA PL/I V2.1.7. The program level refers to the APAR fixes incorporated into the program. The service level refers to the PTFs integrated.
No APARs have been incorporated into VA PL/I V2.1.7.
No PTFs against this release of VA PL/I V2.1.7 have been incorporated into the product.
The following sections identify the system requirements for installing and activating the VA PL/I V2.1.7 OS/390 components. The following terminology is used:
In many cases, the same system can be used as both a driving system and a target system. However, you may want to set up a clone of your system to use as a target system by making a separate IPL-able copy of the running system. The clone should include copies of all system libraries that SMP/E updates, copies of the SMP/E CSI data sets that describe the system libraries, and your PARMLIB and PROCLIB.
Some cases where two systems should be used include the following:
This section describes the environment of the driving system required to install the VA PL/I V2.1.7 OS/390 components.
The driving system can run in any hardware environment that supports the required software.
The following table shows the software requirements for the driving system:
Program number | Product name and minimum VRM/service level |
---|---|
Any one of the following: | |
5647-A01 | OS/390 SMP/E Version 2 Release 5 with PTF UR51068 |
5647-A01 | OS/390 SMP/E Version 2 Release 6 with PTF UR51068 |
5647-A01 | OS/390 SMP/E Version 2 Release 7 or higher |
This section describes the environment of the target system required to install and use the VA PL/I V2.1.7 OS/390 components.
The VA PL/I V2.1.7 OS/390 components install in the MVS (Z038) SREL.
The target system can run in any hardware environment that supports the required software.
A mandatory requisite is defined as a product that is required without exception; this product either will not install or will not function unless this requisite is met. This includes products that are specified as REQs or PREs. The mandatory requisite for installing
Program number | Product name and minimum VRM/service level |
---|---|
5647-A01 | OS/390 Version 2 Release 5 or higher |
A functional requisite is defined as a product that is not required for the successful installation of this product or for the basic function of the product, but is needed at run time for a specific function of this product to work. This includes products that are specified as IF REQs.
See Installing the prerequisite OS/390 software for the list of functional requisites.
VA PL/I V2.1.7 OS/390 libraries can reside on any currently supported DASD.
The following table lists the total space required for each type of library:
Library type | Total space required |
---|---|
Target | 13 tracks |
Distribution | 31 tracks |
HFS | 18 tracks |
For more information on the names and sizes of the required data sets, please refer to Allocate SMP/E target and distribution libraries and paths.
The following tables describe the target and distribution libraries and HFS paths required to install the VA PL/I V2.1.7 OS/390 components. The storage requirements of the VA PL/I V2.1.7 OS/390 components must be added to the storage required by other programs having data in the same library or path.
Note: The data in these tables should be used when you determine which libraries can be merged into common data sets. In addition, because some ALIAS names may not be unique, ensure that no naming conflicts will be introduced before you merge libraries.
The following table shows the storage requirements for VA PL/I V2.1.7 OS/390 target libraries:
Library DDNAME |
Member type |
Target volume |
Type | Org | RECFM | LRECL | No. of 3390 tracks |
No. of dir blocks |
---|---|---|---|---|---|---|---|---|
SFBNLOAD | LMOD | ANY | U | PDS | U | 0 | 7 | 2 |
SFBNSAMP | Sample | ANY | U | PDS | FB | 80 | 4 | 3 |
SFBNSAMV | Sample | ANY | U | PDS | VB | 80 | 2 | 2 |
The following table shows the HFS paths for VA PL/I V2.1.7:
DDNAME | Path name |
---|---|
SFBNFBIN | usr/lpp/ffsserver/bin |
SFBNFLIB | usr/lpp/ffsserver/lib |
SFBNFSAM | usr/lpp/ffsserver/samples |
SFBNFWEB | usr/lpp/ffsserver/WebServ |
The following table shows the storage requirements for VA PL/I V2.1.7 OS/390 distribution libraries:
Library DDNAME |
Type | Org | RECFM | LRECL | No. of 3390 tracks |
No. of dir blocks |
---|---|---|---|---|---|---|
AFBNMOD1 | U | PDS | U | 0 | 8 | 2 |
AFBNSAMP | U | PDS | FB | 80 | 6 | 3 |
AFBNSAMV | U | PDS | VB | 80 | 2 | 2 |
AFBNFFSV | U | PDS | VB | 255 | 15 | 2 |
This section describes the installation method and the step-by-step procedures to install the VA PL/I V2.1.7 OS/390 components.
Please note the following:
This release of the VA PL/I V2.1.7 OS/390 components is installed using the SMP/E RECEIVE, APPLY, and ACCEPT commands. The SMP/E dialogs may be used to accomplish the SMP/E installation steps.
The recommended values for some SMP/E CSI subentries are shown in the following table:
Subentry | Value | Comment |
---|---|---|
DSSPACE | 300,150,250 | Space allocation for SMPTLIB data sets |
PEMAX | SMP/E default | IBM recommends using the SMP/E default for PEMAX. |
Use of values lower than these may result in failures in the installation process. DSSPACE is a subentry in the GLOBAL options entry. PEMAX is a subentry of the GENERAL entry in the GLOBAL options entry. Refer to the SMP/E manuals for instructions on updating the global zone.
The VA PL/I V2.1.7 OS/390 components use the CALLLIBS function provided in SMP/E to resolve external references during installation. When the VA PL/I V2.1.7 OS/390 components are installed, ensure that DDDEFs exist for the following libraries:
Note: The DDDEFs above are used only to resolve the link-edit for the VA PL/I V2.1.7 OS/390 components using CALLLIBS. These data sets are not updated during the installation of the VA PL/I V2.1.7 OS/390 components.
Here are the steps required to install the VA PL/I OS/390 components:
There is a sample job provided on the CD-ROM that will allocate sequential data sets on the OS/390 for the four compressed RELFILEs and SMPMCS contained on the CD-ROM. Do the following to upload it from the CD-ROM to the OS/390:
//ALLOC1 EXEC PGM=IEFBR14 //* //FTPALLO DD DSN=hlq.IBM.HFBN100.SEQ5JCL, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // BLKSIZE=6160, // SPACE=(TRK,(2,1)), // UNIT=SYSALLDA //* VOL=SER=&TVOL1
User enters: | Values |
---|---|
mvsaddr | TCP/IP address of the OS/390 |
tsouid | Your TSO user ID |
tsopw | Your TSO password |
d: | Your CD-ROM drive |
hlq | High-level qualifier you used for the data set you allocated in the job above |
C:\>ftp mvsaddr Connected to mvsaddr. 220-FTPD1 IBM FTP CS V2R8 at mvsaddr, 07:18:16 on 2000-05-11. 220 Connection will close if idle for more than 60 minutes. User (mvsaddr:(none)): tsouid 331 Send password please. Password: tsopw 230 tsouid is logged on. Working directory is "tsouid.". ftp> cd .. 250 "" is the working directory name prefix. ftp> cd hlq 250 "hlq." is the working directory name prefix. ftp> binary 200 Representation type is Image ftp> put d:\hfbn100\ibm.hfbn100.seq5jcl ibm.hfbn100.seq5jcl 200 Port request OK. 125 Storing data set hlq.ibm.hfbn100.seq5jcl 250 Transfer completed successfully. 8400 bytes sent in 0.34 seconds (24.63 Kbytes/sec) ftp> quit 221 Quit command received. Goodbye.
C:\>ftp mvsaddr Connected to mvsaddr. 220-FTPD1 IBM FTP CS V2R8 at mvsaddr, 07:18:16 on 2000-05-11. 220 Connection will close if idle for more than 60 minutes. User (mvsaddr:(none)): tsouid 331 Send password please. Password: tsopw 230 tsouid is logged on. Working directory is "tsouid.". ftp> cd .. 250 "" is the working directory name prefix. ftp> cd hlq 250 "hlq." is the working directory name prefix. ftp> binary 200 Representation type is Image ftp> prompt Interactive mode Off. ftp> mput d:\hfbn100\ibm.hfbn100.f* 200 Port request OK. 125 Storing data set hlq.IBM.HFBN100.F1.BIN 250 Transfer completed successfully. 194960 bytes sent in 0.39 seconds (499.90 Kbytes/sec) 200 Port request OK. 125 Storing data set hlq.IBM.HFBN100.F2.BIN 250 Transfer completed successfully. 202720 bytes sent in 0.40 seconds (506.80 Kbytes/sec) 200 Port request OK. 125 Storing data set hlq.IBM.HFBN100.F3.BIN 250 Transfer completed successfully. 1280 bytes sent in 0.00 seconds (1280000.00 Kbytes/sec) 200 Port request OK. 125 Storing data set hlq.IBM.HFBN100.F4.BIN 250 Transfer completed successfully. 471200 bytes sent in 0.91 seconds (517.23 Kbytes/sec) ftp> put d:\hfbn100\ibm.hfbn100.smpmcs 200 Port request OK. 125 Storing data set hlq.IBM.HFBN100.SMPMCS 250 Transfer completed successfully. 3760 bytes sent in 0.00 seconds (3760000.00 Kbytes/sec) ftp> quit 221 Quit command received. Goodbye.
You can expand the RELFILEs by using the TSO receive command:
receive inda('hlq.ibm.hfbn100.f1.bin') receive inda('hlq.ibm.hfbn100.f2.bin') receive inda('hlq.ibm.hfbn100.f3.bin') receive inda('hlq.ibm.hfbn100.f4.bin')
You can install the VA PL/I OS/390 components in the same SMP/E zone as OS/390 Version 2 Release 5 (or later) or in a different zone.
The sample installation jobs to help you install the VA PL/I OS/390 component are listed in the following table:
Job name | Job type | Description | RELFILE |
---|---|---|---|
FBNIRECV | RECEIVE | Sample RECEIVE job | IBM.HFBN100.F1 |
FBNIALLO | ALLOCATE | Sample job to allocate target and distribution libraries | IBM.HFBN100.F1 |
FBNISMKD | MKDIR | Sample job to invoke the supplied FBNIMKDR EXEC to allocate HFS paths | IBM.HFBN100.F1 |
FBNIDDDF | DDDEF | Sample job to define SMP/E DDDEFs | IBM.HFBN100.F1 |
FBNIAPPL | APPLY | Sample APPLY job | IBM.HFBN100.F1 |
FBNIACCP | ACCEPT | Sample ACCEPT job | IBM.HFBN100.F1 |
Before you edit and submit these jobs, you may want to copy them to another data set, so that you have the original to refer to.
Edit and submit sample job FBNIRECV to perform the SMP/E RECEIVE for VA PL/I V2.1.7. Consult the instructions in the sample job for more information.
Expected return codes and messages: You will get a return code of 0 if the jobs run correctly.
Edit and submit sample job FBNIALLO to allocate the SMP/E target and distribution libraries for VA PL/I V2.1.7. Consult the instructions in the sample job for more information.
Expected return codes and messages: You will get a return code of 0 if the jobs run correctly.
Edit and submit sample job FBNISMKD to allocate the HFS paths for VA PL/I V2.1.7. Consult the instructions in the sample job for more information.
If you plan to create a new HFS for this product, you should consider updating the BPXPRMxx PARMLIB member to mount the new HFS at IPL time. This may be helpful if an IPL occurs before the installation is complete.
Expected return codes and messages: You will get a return code of 0 if the jobs run correctly.
Edit and submit sample job FBNIDDDF to create DDDEF entries for the SMP/E target and distribution libraries for VA PL/I V2.1.7. Consult the instructions in the sample job for more information.
Expected return codes and messages: You will get a return code of 0 if the jobs run correctly. You may receive the following message for the first CHANGE command in the DEFPATH step: 'GIM2650W THE PATH SUBENTRY WAS NOT CHANGED.' This message is expected and can be ignored. If you receive this message, a return code of 4 is expected for the DEFPATH step.
Edit and submit sample job FBNIAPPL to perform an SMP/E APPLY CHECK for VA PL/I V2.1.7. Consult the instructions in the sample job for more information.
To receive the full benefit of the SMP/E Causer SYSMOD Summary Report, do not bypass the following on the APPLY CHECK: PRE, ID, REQ, and IFREQ. This is because the SMP/E root cause analysis identifies the cause only of ERRORS and not of WARNINGS (SYSMODs that are bypassed are treated as warnings, not errors, by SMP/E).
After you have taken any actions indicated by the APPLY CHECK, remove the CHECK operand and run the job again to perform the APPLY.
Note: The GROUPEXTEND operand indicates that SMP/E apply all requisite SYSMODs. The requisite SYSMODs might be applicable to other functions.
Expected return codes and messages: You will get a return code of 0 if the jobs run correctly.
Before you perform the SMP/E ACCEPT, you may want to do the configuration documented in Configuring the foreign file system server. This includes a procedure for verifying the install.
Edit and submit sample job FBNIACCP to perform an SMP/E ACCEPT CHECK for VA PL/I V2.1.7. Consult the instructions in the sample job for more information.
To receive the full benefit of the SMP/E Causer SYSMOD Summary Report, do not bypass the following on the ACCEPT CHECK: PRE, ID, REQ, and IFREQ. This is because the SMP/E root cause analysis identifies the cause only of ERRORS and not of WARNINGS (SYSMODs that are bypassed are treated as warnings, not errors, by SMP/E).
Before using SMP/E to load new distribution libraries, it is recommended that you set the ACCJCLIN indicator in the distribution zone. This will cause entries produced from JCLIN to be saved in the distribution zone whenever a SYSMOD containing inline JCLIN is accepted. For more information on the ACCJCLIN indicator, see the description of inline JCLIN in the SMP/E manuals.
After you have taken any actions indicated by the ACCEPT CHECK, remove the CHECK operand and run the job again to perform the ACCEPT.
Note: The GROUPEXTEND operand indicates that SMP/E apply all requisite SYSMODs. The requisite SYSMODs might be applicable to other functions.
Expected return codes and messages: You will get a return code of 0 if the jobs run correctly.
If PTFs containing replacement modules are being accepted with SMP/E, SMP/E ACCEPT processing will link-edit or bind the modules into the distribution libraries. During this processing, the Linkage Editor or Binder may issue messages documenting unresolved external references, resulting in a return code of 4 from the ACCEPT step. These messages can be ignored, because the distribution libraries are not executable and the unresolved external references will not affect the executable system libraries.
The SMP/E modification control statements (SMPMCS) for VA PL/I V2.1.7 are contained in the SMPMCS file uploaded from the distribution CD. The SMPMCS for each FMID in the product will be loaded to the SMPPTS data set, with a member name matching the FMID, when you receive the FMID with SMP/E RECEIVE. You can browse or print these members using TSO/E, ISPF, or IEBGENER (or IEBPTPCH).
The JCLIN for VA PL/I V2.1.7 is contained in the RELFILEs uploaded from the distribution CD. These files will be loaded to disk by SMP/E when you receive the product with SMP/E RECEIVE. You can browse or print these files using TSO/E, ISPF, or IEBGENER (or IEBPTPCH).
The files containing JCLIN are:
FMID HFBN100: hlq.IBM.HFBN100.F1(HFBN100)
Note: The high-level qualifier (hlq) is the qualifier specified as the DSPREFIX in the SMP/E OPTIONS.
You will be setting up the server to run in nonsecure mode. Details are available in the IBM HTTP Server documentation. (We use IBM HTTP Server to refer to all the server versions, but you might be using Domino Go Webserver if you have OS/390 Version 2 Release 5 or 6.) Your installation may have additional requirements such as workload management and proxy caching, but VisualAge PL/I does not need these.
You can configure the IBM HTTP Server to your specifications by setting permissions, configuring language, customizing the server environment, and so on. You must do this configuring from the OS/390 UNIX shell using the Web administration user ID and group, by either of these methods:
Each method of configuring changes the statements (called directives) in the configuration file. Restart the server after you make changes to ensure that the changes take effect.
The following steps are based on the HTTP Server directions for installing it the first time (as opposed to migrating from a previous version of the server):
RDEFINE PROGRAM * ADDMEM('SYS1.SCEERUN'//NOPADCHK) UACC(READ)
RDEFINE PROGRAM * ADDMEM('CBC.SCLBDLL'//NOPADCHK) UACC(READ)
RDEFINE PROGRAM * ADDMEM('SYS1.LINKLIB') UACC(READ)
SETROPTS WHEN(PROGRAM) REFRESH
In this example, * is all programs in the data set or a specified program
in the specified data set.
Indicate that the server and Language Environment LOADLIBs are trusted
programs.
/usr/lpp/internet/
,
substitute your install path.You can start the server using the start-up procedure IMWEBSRV. Make sure the procedure is a member in a PROCLIB data set. Enter the following command from the OS/390 operator console:
S IMWEBSRV
You can also start the proc when TCP/IP is started by adding START IMWEBSRV to the TCP/IP profile. Or you can use the httpd command, which is also documented in Appendix B of the IBM HTTP Server planning manual.
Example: JCL for starting the IBM HTTP Server
RELATED TASKS
Installing the prerequisite OS/390 software
IBM
HTTP Server: Planning, Installing, and Using, SC31-8690
IBM
HTTP Server Troubleshooting Guide
Domino
Go Release 5.0 Webmaster's Guide, SC31-8691
Configuring OS/390 for remote ECD: overview
RELATED REFERENCES
HTTP directives for VisualAge PL/I
You need to configure the following directives for the IBM HTTP Server to operate with VisualAge PL/I. You can probably use the default settings for the other directives. However, review all the directives shown in the server documentation to make sure that the defaults are appropriate for your environment.
The MaxPersistRequest directive specifies the maximum number of requests that the server will allow on a persistent connection. VisualAge PL/I requires a value of 5 or greater. Specify the MaxPersistRequest directive as follows:
MaxPersistRequest 5
You need to enable the Go Webserver API (GWAPI) services used by VisualAge PL/I and provide the paths for the VisualAge PL/I server routines. The file /ffsserver/samples/fbnfconf contains sample configuration information for the foreign file system:
Enable FFS_WOPEN /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvr Enable FFS_GET /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvr Enable FFS_DIR /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvr Enable FFS_DELETE /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvr Enable FFS_RENAME /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvr Enable FFS_RMDIR /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvr Enable FFS_ALLOCATE /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvr Enable FFS_CONNECT /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvr Enable FFS_STCMDSRV /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvr ServerInit /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvrInit TRACE_ERRORS ServerTerm /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvrTerm Service /FFSDS* /usr/lpp/ffsserver/lib/fbnfmain.dll:ffssrvr* Pass /FBN-PUB/* /usr/lpp/ffsserver/WebServ/*
Note: file /ffsserver/samples/fbnfconf contains some errors that have been corrected by PTF IP22114. The example above is correct.
If you did not install into the default path (usr/lpp/ffsserver), you need to change the paths accordingly.
Prepend these directives to the Web server configuration file
The settings for these directives control the kind of information presented in directory listings. VisualAge PL/I requires the following settings:
DirAccess | on | DirShowBrackets | on |
DirReadme | top | DirShowCase | on |
DirShowIcons | on | DirShowHidden | off |
DirShowDate | on | DirShowBytes | off |
DirShowSize | on | DirShowMaxDescrLength | 25 |
DirShowDescription | on | DirShowMinLength | 15 |
RELATED TASKS
Configuring the IBM HTTP Server
IBM
HTTP Server: Planning, Installing, and Using, SC31-8690
Domino
Go Webmaster's Guide, SC31-8691
If you changed any of the default names while configuring the IBM HTTP Server, you need to make similar changes in this JCL.
//IMWPROC PROC LEPARM=,ICSPARM= //********************************************************************* //* PARM='LE runtime opts/ICS parms' //* //* LEPARM ==> LE runtime opts //* LEPARM='ENVAR("_CEE_ENVFILE=/etc/httpd.envvars.tmp")' //* //* ICSPARM ==> Internet Connection Server parameters //* # Standalone HTTPD //* ICSPARM='-p 8080 //* # WLM Queue Manager //* ICSPARM='-SN WEBSN1 -p 8080 //* # WLM ApplEnv Queue Server //* ICSPARM='-SN WEBSN1 -AE WEBHTML' //* //* Internet Connection Server Parameters: //* -SN # WLM - subsystem name //* -AE # WLM - Application Envirnonment //* //* -fscp nnn # File system codepage - EBCDIC //* -netcp nnn # net code page - ASCII //* //* -gc_only # clean cache & exit (garbage collect) //* //* -normalmode //* -p nnnn # use port nnn (default 80) //* -sslmode //* -sslport nnnn # use port nnn (default 443) //* -nosec # no security //* //* -nosmf # no smf processing on //* -smf # smf processing on //* //* -r /etc/httpd.conf # use rule file xxxx //* -restart //* -v # trace to stderr //* -vv # trace all to stderr //* -vc # cache trace to stderr //* //* -version # show version and exit //* //* xxxxxxx # ServerRoot xxxxxxx; Pass /* //* //********************************************************************* //WEBSRV EXEC PGM=IMWHTTPD,REGION=0K,TIME=NOLIMIT, // PARM=('&LEPARM/&ICSPARM') //********************************************************************* //SYSIN DD DUMMY //OUTDSC OUTPUT DEST=HOLD //SYSPRINT DD SYSOUT=*,OUTPUT=(*.OUTDSC) //SYSERR DD SYSOUT=*,OUTPUT=(*.OUTDSC) //STDOUT DD SYSOUT=*,OUTPUT=(*.OUTDSC) //STDERR DD SYSOUT=*,OUTPUT=(*.OUTDSC) //SYSOUT DD SYSOUT=*,OUTPUT=(*.OUTDSC) //CEEDUMP DD SYSOUT=*,OUTPUT=(*.OUTDSC)
RELATED TASKS
Configuring the IBM HTTP Server
To install the code for the foreign file system server, do the following steps:
Append to this variable (in httpd.envvars file): | Path where the following files were installed: | Default value |
---|---|---|
LIBPATH variable | fbnfmain.dll and fbnfdir.dll | /usr/lpp/ffsserver/lib |
PATH variable | fbnflock and fbnfscmd | /usr/lpp/ffsserver/bin |
_BPXK_SETIBMOPT_TRANSPORT=tcpipstackname
Here tcpipstackname is the name of your TCP/IP stack. See UNIX System Services Planning for a description of the _BPXK_SETIBMOPT_TRANSPORT environment variable.
chmod +rx fbnfmain.dll chmod +rx fbnfdir.dll chmod +rx fbnflock chmod +rx fbnfscmd
extattr +p fbnfmain.dll extattr +p fbnfdir.dll extattr +p fbnflock
FILESYSTYPE TYPE(UDS) ENTRYPOINT(BPXTUINT) NETWORK DOMAINNAME(AF_UNIX) DOMAINNUMBER(1) MAXSOCKETS(64) TYPE(UDS) FILESYSTYPE TYPE(INET) ENTRYPOINT(BPXTIINT) NETWORK DOMAINNAME(AF_INET) DOMAINNUMBER(2) MAXSOCKETS(64) TYPE(INET)
For more information about these statements and the BPXPRMxx parmlib member in general, see UNIX System Services Planning.
You can verify that the foreign file system server has been installed correctly without testing it through VisualAge PL/I. From a browser on the workstation, enter the following address:
http://systemname:webserverport/FFSDS/
Here systemname is the TCP/IP host name or address of the OS/390 system, and webserverport is the port number for the IBM HTTP Server (the default is 80). FFSDS must be uppercase, and the final slash (/) must be used. You should see the home page for the foreign file system server.
RELATED TASKS
Installing the prerequisite OS/390 software
Configuring OS/390 for remote ECD: overview
RELATED REFERENCES
UNIX
System Services Planning, SC28-1890 (about the _BPXK_SETIBMOPT_TRANSPORT
environment variable and BPXPRMxx parmlib member)
Be sure that you have installed the appropriate PTF for the JES APAR OW41734, which enables viewing of output from the job monitor
Using the earlier steps for installing the job monitor, you installed the following data sets from the CD to your system:
Load module | SFBNLOAD(FBNJMON) |
Configuration file | SFBNSAMV(FBNJCNFG) |
JCL file | SFBNSAMP(FBNJJCL) |
Use the following steps to configure the job monitor server on the host:
AUTHMETHOD=RACF CODEPAGE=UTF-8 HOST_CODEPAGE=IBM-1047 __JCL=YES JES=JES2 JESNAME=JES2 LISTEN_QUEUE_LENGTH=5 MAX_DAEMONS=10 MAX_DATASETS=32 MAX_LINECOUNT=15000 MAX_THREADS=200 SERV_PORT=6715 TIMEOUT_INTERVAL=1200 TIMEOUT=3600 TZ=PST5PDT
Both the client and the server must be configured with the same port number. If you change the server port number, the developers must also change the client port number by using the MVS connections manager.
RELATED TASKS
Installing the prerequisite OS/390 software
Configuring OS/390 for remote ECD: overview
The TSO commands server uses an APPC/MVS transaction to execute TSO commands. The FFS server starts the APPC transaction (IELFSERV), which acts as a host server to execute TSO commands that are issued from the workstation through TCP/IP. APPC is not required on the workstation because it communicates with IELFSERV through TCP/IP.
Each workstation can have an active connection to each host at the same time.
The following steps are in preparation for configuring the server on the host. You (the system programmer or APPC administrator) may already have done the first and third steps:
The system programmer or APPC administrator needs to do the following steps to configure the command facility:
CLASSADD CLASSNAME(DEFAULT) MAX(20) MIN(1) MSGLIMIT(5000) OPTIONS DEFAULT(DEFAULT) TPDEFAULT REGION(2M) TIME(5) MSGLEVEL(1,1) OUTCLASS(9)
If you cannot use the command facility, there are two main areas where problems can arise: connecting to MVS and starting the APPC server transaction.
If you do not see the messages about setting up APPC, check the system log for RACF messages or other messages related to the command that was issued or the user ID that issued it. Common causes of problems include:
If you see the messages about setting up APPC but do not see the message confirming that setup succeeded, the APPC server transaction was probably unable to start. If the error log (userid.IELFSERV.&TPDATE.&TPTIME.LOG) for the conversation exists, check it. Some of the likely causes of problems are:
Example: JCL for defining the APPC transaction
RELATED TASKS
Installing the prerequisite OS/390 software
Configuring OS/390 for remote ECD: overview
For the TSO commands server, the job card and some of the JCL in IELFTPAD need to be modified to meet the requirements of your site. The user ID for the IELFTPAD job must be authorized to APPC before you run the job.
1 //IELFTPAD JOB (XX,YY),CLASS=A,MSGCLASS=A,MSGLEVEL=(1,1) 2 //* 3 //TPADD EXEC PGM=ATBSDFMU 4 //SYSPRINT DD SYSOUT=* 5 //SYSSDLIB DD DSN=SYS1.APPCTP,DISP=SHR 6 //SYSSDOUT DD SYSOUT=* 7 //SYSIN DD DATA,DLM='QT' 8 TPADD 9 TPNAME(IELFSERV) (1) 10 ACTIVE(YES) 11 TPSCHED_DELIMITER(DLM1) 12 KEEP_MESSAGE_LOG(ERROR) 13 MESSAGE_DATA_SET(&SYSUID.IELFSERV.&TPDATE.&TPTIME.LOG) 14 DATASET_STATUS(MOD) 15 CLASS(DEFAULT) (2) 16 JCL_DELIMITER(DLM2) 17 //IELFSERV JOB (3) 18 //* 19 //IKJACCNT EXEC PGM=IKJEFT01,DYNAMNBR=50,PARM='%IELFSERV TIMEOUT=60' (4) 20 //SYSPROC DD DSN=IELV1R10.SIELCLST,DISP=SHR (5) 21 //SYSPRINT DD SYSOUT=* 22 //* SYSTCPD DD DSN=SYS1.TCPIP.DATA,DISP=SHR (6) 23 //* SYSTSPRT DD DSN=&SYSUID..IELFSERV.OUTPUT,DISP=SHR 24 //SYSTSPRT DD SYSOUT=* (7) 25 //SYSTSIN DD DUMMY 26 DLM2 27 DLM1 28 QT
RELATED TASKS
Installing and configuring the TSO commands server (optional)
Debug Tool consists of two partitioned data sets:
The only configuring that Debug Tool needs is for CICS.
For a developer to use TCP/IP sessions to carry the communications for remote debugging of CICS applications, a systems administrator needs to take the following actions:
For a detailed explanation on activating TCP/IP in the CICS region, see CICS TCP/IP Socket Interface Guide and Reference.
RELATED TASKS
Installing the prerequisite OS/390 software
Configuring OS/390 for remote ECD: overview
RELATED REFERENCES
CICS
TCP/IP Socket Interface Guide and Reference, SC31-7131
CICS/ESA
Resource Definition Guide, SC33-1166
CICS/ESA
Operations Guide, SC33-0668