Compaq NonStop Pathway/iTS Web Client Programming Manual Abstract This manual describes how to convert SCREEN COBOL requesters to web clients and explains how to build and deploy those clients. It also provides the information Java developers and web designers need to modify and enhance the Java and HTML portions of the converted clients. Product Version Pathway/iTS 1.
Document History Part Number Product Version Published 426746-001 Pathway/iTS 1.0 October 2000 520270-001 Pathway/iTS 1.0 Update June 2001 Ordering Information For manual ordering information: domestic U.S. customers, call 1-800-243-6886; international customers, contact your local sales representative. Document Disclaimer Information contained in a manual is subject to change without notice. Please check with your authorized representative to make sure you have the most recent information.
Compaq NonStop Pathway/iTS Web Client Programming Manual Index Examples Figures Tables What’s New in This Manual v About This Manual ix 1. Introduction to Pathway/iTS Web Clients Development Process for Web Clients 1-1 Run-Time Environment for Web Clients 1-2 2. How to Compile, Build, and Maintain a Pathway/iTS Web Client 1. Prepare the SCREEN COBOL Object File 2-2 2. Create a Configuration File 2-2 3. Run the Converter 2-3 4. Modify Java or SCREEN COBOL Code As Needed 2-4 5.
5. SCREEN COBOL-to-Web Conversion Mappings Contents 5. SCREEN COBOL-to-Web Conversion Mappings Components of the Web Client 5-2 Conversion Mappings 5-3 6. Java Import Package Reference Host Connectivity Classes 6-1 HTML Screen Interaction Classes 6-9 Data-Type Classes 6-38 6-105 Transform Class ProgramUnit Class 6-109 Special-Register Classes Exception Classes 6-112 6-117 User Conversion Classes 6-122 A. Client Error Messages General Information A-1 Message Descriptions A-1 B.
Figures Contents Figures Figure 1-1. Development of a Pathway/iTS Web Client 1-2 Figure 1-2. Run-Time Environment for a Pathway/iTS Web Client 1-3 Tables Table B-1.
Contents Compaq NonStop Pathway/iTS Web Client Programming Manual— 520270-001 iv
What’s New in This Manual Manual Information Compaq NonStop Pathway/iTS Web Client Programming Manual Abstract This manual describes how to convert SCREEN COBOL requesters to web clients and explains how to build and deploy those clients. It also provides the information Java developers and web designers need to modify and enhance the Java and HTML portions of the converted clients. Product Version Pathway/iTS 1.
What’s New in This Manual • • • Corrections and Enhancements to the Manual Changed the step for setting up the user profile database from optional to required. See 5. Run PROFDBM to Set Up the User Profile Database on page 2-4. Section 4: User-Written User Conversion Procedures for Web Clients • Corrected the nld utility command description in Build Your User Conversion Library on page 4-2.
What’s New in This Manual Corrections and Enhancements to the Manual Compaq NonStop Pathway/iTS Web Client Programming Manual— 520270-001 vii
What’s New in This Manual Corrections and Enhancements to the Manual Compaq NonStop Pathway/iTS Web Client Programming Manual— 520270-001 viii
About This Manual This manual describes how to convert SCREEN COBOL requesters to web clients and explains how to build and deploy those clients. It also provides the information Java developers and web designers need to modify and enhance the Java and HTML portions of the converted clients.
Your Comments Invited About This Manual NonStop™ TS/MP System Management Manual Pathway/XM System Management Manual Pathway/iTS Management Programming Manual Pathway Products Glossary Operator Messages Manual Describes the interactive management interface to the NonStop TS/MP product and describes how to configure and manage NonStop TS/MP objects. This interface is used together with the Pathway/iTS management interface to configure and manage a Pathway environment.
About This Manual Notation Conventions Notation Conventions Hypertext Links Blue underline is used to indicate a hypertext link within text. By clicking a passage of text with a blue underline, you are taken to the location described. For example: This requirement is described under Backup DAM Volumes and Physical Disk Drives on page 3-2. General Syntax Notation The following list summarizes the notation conventions for syntax presentation in this manual. UPPERCASE LETTERS.
About This Manual General Syntax Notation | Vertical Line. A vertical line separates alternatives in a horizontal list that is enclosed in brackets or braces. For example: INSPECT { OFF | ON | SAVEABEND } … Ellipsis. An ellipsis immediately following a pair of brackets or braces indicates that you can repeat the enclosed sequence of syntax items any number of times. For example: M address-1 [ , new-value ]... [ - ] {0|1|2|3|4|5|6|7|8|9}...
About This Manual Notation for Messages Notation for Messages The following list summarizes the notation conventions for the presentation of displayed messages in this manual. Nonitalic text. Nonitalic letters, numbers, and punctuation indicate text that is displayed or returned exactly as shown. For example: Backup Up. lowercase italic letters. Lowercase italic letters indicate variable items whose values are displayed or returned. For example: p-register process-name [ ] Brackets.
About This Manual Notation for Messages Compaq NonStop Pathway/iTS Web Client Programming Manual— 520270-001 xiv
1 Introduction to Pathway/iTS Web Clients The web client feature of Compaq NonStop™ Pathway/iTS lets you convert a SCREEN COBOL application (a group of related compiled program units within an object library) to a web client and then build and deploy the resulting client in a Pathway environment. The converted web client consists of a combination of Java code and HTML pages. These can be deployed on any web server hosted on the Compaq NonStop™ Kernel operating system.
Run-Time Environment for Web Clients Introduction to Pathway/iTS Web Clients Figure 1-1. Development of a Pathway/iTS Web Client TM Compaq NonStop SCREEN COBOL Source System SCREEN COBOL Compiler SCREEN COBOL Object Code Symbol Table Directory SCUP Utility HTML Pages with JavaScript Java Source Code optional Standard Web Publishing Tools Web Server VST001.vsd The web client consists of a combination of Java code and HTML pages. Requesterbased business logic is converted to Java classes.
Java Import Package Introduction to Pathway/iTS Web Clients Figure 1-2. Run-Time Environment for a Pathway/iTS Web Client Java Import Package Residing on Browser-Based Web Client Internet Proxy Proxy Compaq NonStopTM System Router Gateway Threads TCP Pathway Server Class VST002.vsd Java Import Package Pathway/iTS provides a Java import package used by the converted web clients. This package consists of classes that enable Java-based clients to interact with Pathway applications.
Introduction to Pathway/iTS Web Clients • • • • • Router Process The Transform class, which provides methods to implement the SCREEN COBOL TRANSFORM statement The Program Unit class, which provides methods for setting attributes for a program unit—for example, the currency symbol and the decimal-point character Special-register classes, which define the Java equivalents of the SCREEN COBOL special registers Exception classes, which provide handling for SCREEN COBOL exceptions User conversion classes, whi
Introduction to Pathway/iTS Web Clients Gateway Threads will process the connection request. Multiple routers can thus be used to support more than one gateway application. Gateway Threads The run-time web gateway is implemented as a Pathway/iTS intelligent device support (IDS) requester running on the NonStop Himalaya system under control of the TCP. This requester program is provided as part of Pathway/iTS.
Introduction to Pathway/iTS Web Clients Gateway Threads Compaq NonStop Pathway/iTS Web Client Programming Manual— 520270-001 1 -6
2 How to Compile, Build, and Maintain a Pathway/iTS Web Client This section describes the steps you need to take to convert a SCREEN COBOL program into a Pathway/iTS web client and to compile, build, deploy, and maintain the resulting web client. The steps are as follows: 1. Prepare the SCREEN COBOL Object File 2. Create a Configuration File 3. Run the Converter 4. Modify Java or SCREEN COBOL Code As Needed 5. Run PROFDBM to Set Up the User Profile Database 6. Build the Converted Client 7.
How to Compile, Build, and Maintain a Pathway/iTS Web Client 1. Prepare the SCREEN COBOL Object File 1. Prepare the SCREEN COBOL Object File Before you run the converter, organize the SCREEN COBOL object (POBJ) file so that repeated conversions can be done easily. First, copy the SCREEN COBOL object file to be converted to the desired volume and subvolume. If the SCREEN COBOL object program has its symbols stripped, rebuild the object file with symbols.
How to Compile, Build, and Maintain a Pathway/iTS Web Client 3. Run the Converter To provide a common look and feel for all the web pages, the example provides default values for background color, foreground color, font type, and font size. For the background parameter, you could choose a color or a .gif file that contains the company logo. Specifying default locations for Java and HTML files in the Convert Environment section allows you to save the converted files in a well-known location.
How to Compile, Build, and Maintain a Pathway/iTS Web Client 4. Modify Java or SCREEN COBOL Code As Needed 4. Modify Java or SCREEN COBOL Code As Needed When you run the converter, it returns error or warning messages if it finds any problems or any unsupported SCREEN COBOL statements. In such cases, comments or error messages may also appear in the resulting Java code.
How to Compile, Build, and Maintain a Pathway/iTS Web Client Set Up the Build Environment in an OSS Environment ($volume.subvolume) from which the CONVERT command was run. The MAP file name is composed of the first four or five SCOBOL object file characters plus the characters MAP. For example, if the SCOBOL objects are named MYAPPCOD, MYAPPDIR, and MYAPPSYM, then the MAP file name is MYAPPMAP.
How to Compile, Build, and Maintain a Pathway/iTS Web Client • • Set Up the Build Environment in a Windows Environment Creates a make file for building the application. The name of the make file is specified in the JMAKENV command and is copied to the applicationhome/build directory as make-file.mk. Sets up the environment variables used by the make file. Note. The user running JMAKENV must have permission to create and copy files to the application-home directory in the OSS environment.
How to Compile, Build, and Maintain a Pathway/iTS Web Client Set Up the Build Environment in a Windows Environment JMAKENV does the following when run with the NT option: Creates two batch files (JGETFILE and JPUTFILE) in the same location from which JMAKENV was run. JGETFILE includes FTP commands to move files from the OSS environment to the Windows NT platform. JPUTFILE includes FTP commands to move files from a Windows NT environment to the OSS deployment directory.
How to Compile, Build, and Maintain a Pathway/iTS Web Client Build (Compile) the Application in an OSS Environment password is the password for the userid. This command copies the Java and HTML files to the local directory from where this batch file was run and automatically assigns the appropriate names to the files. After all the files have been transferred, build the application.
How to Compile, Build, and Maintain a Pathway/iTS Web Client Build (Compile) the Application in a Windows Environment Build (Compile) the Application in a Windows Environment Once the Java files are transferred to a Windows environment, you can use the Java compiler available on the machine to compile the Java source. A typical Java compilation on a Windows environment is as follows: DOS> javac *.java 2> error.txt This compiles all Java files in the current directory and creates one or more class files.
How to Compile, Build, and Maintain a Pathway/iTS Web Client • Deploy the Web Client on an OSS Environment Copies all the compiled Java files from the /usr/test/inventory/bin directory to the /usr/webserver/root/testapp directory, where /usr/webserver/root is obtained from the WEBROOT variable in the make file.
How to Compile, Build, and Maintain a Pathway/iTS Web Client • Deploy the Web Client on a Windows Environment Publish all the gif files (which must be in /usr/tandem/webserver/root) -f invymk.mk DEPLOY=testapp gif Deploy the Web Client on a Windows Environment To deploy the compiled Java class files and the HTML files from a Windows environment to an OSS directory under the webroot directory, run the JPUTFILE from the Windows environment.
How to Compile, Build, and Maintain a Pathway/iTS Web Client 8. Customize the Screens If the URL for the default page on the web server is http://intraweb.mycompany.com, you can now test the converted application by using the following URL: http://intraweb.mycompany.com/testapp/INVENTORY_START.html 8. Customize the Screens Copy the HTML Files to be Customized After you deploy the converted application, you can customize the HTML files.
How to Compile, Build, and Maintain a Pathway/iTS Web Client 9. Specify the Port Number of the Router Process 2. Logon to the NonStop Himalaya server then specify the remote OSS directory where the HTML files are deployed. Specify local directory to which the files will get copied. Set the transfer mode to ASCII. ftp ftp ftp ftp > > > > user x.y password cd /usr/webserver/root/testapp lcd c:\htmledit ASCII 3. Use the get or mput command to put one or more HTML files.
How to Compile, Build, and Maintain a Pathway/iTS Web Client 10. Configure Pathway Servers for User Profiles and User Conversion Routines 10. Configure Pathway Servers for User Profiles and User Conversion Routines Whether an end user is required to enter a password or a user profile is controlled by the userAuthenticate and getProfile parameters in the control file that is generated by the CONVERT command.
How to Compile, Build, and Maintain a Pathway/iTS Web Client 12. Maintain the Client session, will be dedicated to that client (applet) until it has performed 5 delegated tasks. After the 5 tasks are completed, the socket connection is broken, the session is closed, and the gateway thread is freed to service another connection request from an applet. There is one case where the specified number of I/O operations is ignored: the BT-ET block.
How to Compile, Build, and Maintain a Pathway/iTS Web Client Modify SCREEN COBOL Source Code Modify SCREEN COBOL Source Code Enhancements and maintenance changes to the SCREEN COBOL source code fall into one of the following categories: • • • Changes to business logic only Changes to business logic and display Changes to display section only Changes to Business Logic Only If only the business logic changes, all the corresponding changes to the web clients are in the Java code.
How to Compile, Build, and Maintain a Pathway/iTS Web Client Modify Java Source Code Only Modify Java Source Code Only To enhance or maintain the Java source files, use your choice of commercially available Java development environments on a platform of your choosing, or use the NonStop Kernel environment.
How to Compile, Build, and Maintain a Pathway/iTS Web Client Modify Java Source Code Only Compaq NonStop Pathway/iTS Web Client Programming Manual— 520270-001 2- 18
3 Logon Security and User Profiles This section describes the logon security and user profile features presented to the user whenever a Pathway/iTS web client is first started. It also describes how to set up the user profile database. Logon Security Whenever an end user opens the browser and goes to the URL for a Pathway/iTS web client application, a logon screen may be displayed, if required. This screen requires the user to enter a user name and password and a profile name.
Actions of the Web Client Logon Security and User Profiles Actions of the Web Client If the logon is successful (that is, if the end user enters a valid user name/password combination), the client application begins to run. However, before the browser displays the starting page of the client application, the application communicates with the host NonStop Himalaya to retrieve information associated with the profile entered by the end user.
Logon Security and User Profiles User Profile Options in the Control File The TERMINAL-PRINTER and LOGICAL-TERMINAL-NAME fields correspond to the SCREEN COBOL special registers of the same names. The five USER-PROFILE-n fields are new special registers in the applet; these fields have no corresponding special registers in SCREEN COBOL programs. Java definitions of the special registers are given under Special-Register Classes on page 6-112.
User Profile Options in the Control File Logon Security and User Profiles Parameter Values Description userAuthenticate=true getProfile = true Specifies that the user must enter a valid Guardian user name, password, and the profile name. The user is authenticated and the profile data from the profile server is retrieved.
Logon Security and User Profiles Use the PROFDBM Utility Use the PROFDBM Utility The user profile database manager (PROFDBM) utility allows you to add, update, search for, and delete records in the USERPROF database. Before using PROFDBM, create the database as follows: TACL> FUP CREATE USERPROF, TYPE K, REC 248, KEYLEN 16 Note. You must use the name USERPROF for this database; do not use any other name.
Logon Security and User Profiles Configure the User Profile Server Class Search for a Record To search for an existing record in the database: 1. Enter the number 3. 2. When prompted, enter the user profile name for the record and press ENTER. 3. PROFDBM displays the current values of all the special registers in that record. A blank after the equals sign for a register indicates a null value. 4. After the values are displayed, PROFDBM prompts you to select another command.
4 User-Written User Conversion Procedures for Web Clients If the SCREEN COBOL application you are converting to a web client includes USER CONVERSION clauses and user-written user conversion procedures, Pathway/iTS supports your existing pTAL user conversion routines running on a NonStop Himalaya. User conversion procedures used with web clients are bound to a special user conversion server class called USER-LIB-SERVER. This server class is then configured to run in the Pathway environment.
User-Written User Conversion Procedures for Web Clients Build Your User Conversion Library Build Your User Conversion Library Assuming that the appropriate SLIB, ILIB, and TLIB files are in place and your user conversion object file has been compiled without errors, build the user conversion library, binding it to the USER-LIB-SERVER server class, by invoking the nld utility from the TACL prompt as follows: NLD user-conversion-object $volume.ZPITS.
User-Written User Conversion Procedures for Web Clients Configure the User Conversion Server Class where scmyuser is the program file name you specified when you built your user conversion library. If you are using a PATHCOM configuration file, also include the following command in the list of SET SERVER commands: SET SERVER PROCESSTYPE GUARDIAN Note. The name of the server class specified in the ADD SERVER command must be USER-LIB-SERVER. The converted code will work correctly only if this name is used.
User-Written User Conversion Procedures for Web Clients Configure the User Conversion Server Class Compaq NonStop Pathway/iTS Web Client Programming Manual— 520270-001 4 -4
5 SCREEN COBOL-to-Web Conversion Mappings This section describes the structure and content of a Pathway/iTS Web client as generated by the converter invoked by the SCUP CONVERT command. It also describes how the elements of the SCREEN COBOL program map into the corresponding elements of the client Java and HTML code. The information in this section can be useful to you if you are modifying portions of the Java or HTML code after conversion.
SCREEN COBOL-to-Web Conversion Mappings Components of the Web Client Components of the Web Client For each SCREEN COBOL application, the converter generates the following Java classes and HTML files: • • • • • • Main Java applet Starting page Initial page Control page Java classes for the program units User HTML pages for the Screen Sections Main Java Applet The main applet is contained in a file named initprog_MAINAPP.
SCREEN COBOL-to-Web Conversion Mappings Control Page Control Page Each converted SCREEN COBOL application is managed through a control page. This HTML page is loaded into a control frame that is created by the starting page. The control page contains a MainApp applet. This page is not visible to the end user. It remains active throughout the execution of the application. The name of the control page is derived from the user-specified INITIAL program unit followed by _CONTROL.
SCREEN COBOL-to-Web Conversion Mappings Mappings to Java Classes described in Section 6, Java Import Package Reference. The name of the nested Java class is derived by prefixing the name of the group item with c_. Each data item in the Working-Storage Section is mapped to a Java object. Hyphens in the SCREEN COBOL names are replaced by underscores in the Java names. An instance of each elementary item is created by using the data-type objects provided in the Java import package.
SCREEN COBOL-to-Web Conversion Mappings Mappings to Java Classes Conversion of Paragraphs Each program unit class has a method named eXecute. This method provides the starting point for executing that class. Each paragraph in the SCREEN COBOL program is converted to a method in the Java code. The names of these methods are derived from the names of the corresponding paragraphs, with hyphens replaced by underscores.
Mappings to Java Classes SCREEN COBOL-to-Web Conversion Mappings • • In PROCESS-PARA, the MOVE SPACES statement is converted to calls to the setSpaces() methods in the FIRST_NAME and LAST_NAME data objects. To display the NAME-SCREEN base screen, the converted code invokes the displayBase method in the HTMLHandler object, passing the name of the related HTML file.
Mappings to User HTML Pages SCREEN COBOL-to-Web Conversion Mappings For example, suppose that the following declarations appear in the SCREEN COBOL source code: WORKING-STORAGE SECTION. 01 WS-ITEM1 PIC 9(4) VALUE 4444. 01 WS-ITEM2 PIC 9(4) VALUE 8888. SCREEN SECTION. ... 05 SCR-ITEM1 AT 10,10 PIC 9(4) FROM WS-ITEM1 TO WS-ITEM2. Then the following statement will display 4444 on the screen: DISPLAY SCR-ITEM1.
SCREEN COBOL-to-Web Conversion Mappings Mappings to User HTML Pages Example 5-7 shows a sample Screen Section in a SCREEN COBOL program. Example 5-7. SCREEN COBOL Screen Section 01 NAME-SCREEN BASE SIZE 24, 80. 05 FILLER AT 05, 10 05 EMP-FIRST-NAME AT 05, 30 05 FILLER AT 10, 10 05 EMP-LAST-NAME AT 10, 30 05 OV-AREA AREA AT 12, 10 SIZE VALUE "ENTER FIRST NAME". PIC X(10) USING FIRST-NAME. VALUE "ENTER LAST NAME". PIC X(30) USING LAST-NAME. 5, 50 Example 5-8 illustrates the corresponding HTML code.
6 Java Import Package Reference This section defines the public classes and methods in the Pathway/iTS Java import package, pathway.its. This package enables Java-based clients to interact with Pathway applications.
Java Import Package Reference Class Gateway Class Gateway The Gateway class encapsulates the connectivity protocol with the host NonStop Himalaya and also delegates certain host processing on behalf of the clients. Package pathway.its Syntax public pathway.its.
Class Gateway Java Import Package Reference Delegation Methods abortTransaction() Aborts the current transaction on the NonStop Himalaya; equivalent to the SCREEN COBOL ABORT-TRANSACTION statement. acceptDate() Gets the NonStop Himalaya date; equivalent to the SCREEN COBOL ACCEPT DATE statement. acceptDay() Gets the NonStop Himalaya Julian day; equivalent to the SCREEN COBOL ACCEPT DAY statement. acceptTime() Gets the NonStop Himalaya time; equivalent to the SCREEN COBOL ACCEPT TIME statement.
Class Gateway Java Import Package Reference Description Equivalent to the SCREEN COBOL ABORT-TRANSACTION statement. Method acceptDate Purpose Gets the date from the NonStop Himalaya. Syntax public void acceptDate (ScobolType date, boolean yyyymmdd) throws ScobolTxnException Description Equivalent to the SCREEN COBOL ACCEPT DATE statement. Parameters date The object that will receive the date. yyyymmdd If true, the date will be returned in yyyymmdd format; otherwise, it will be in yymmdd format.
Class Gateway Java Import Package Reference Syntax public void acceptTime (ScobolType time) throws ScobolTxnException Description Equivalent to the SCREEN COBOL ACCEPT TIME statement. Parameters The object that will receive the time time Method beginTransaction Purpose Initiates a transaction on the NonStop Himalaya on behalf of this client. Syntax public void beginTransaction () throws ScobolTxnException Description Equivalent to the SCREEN COBOL BEGIN-TRANSACTION statement.
Class Gateway Java Import Package Reference Parameters onTxnErrorMethod The name of the transaction error-handling method. If null or if the method name is not found, then no method is invoked if a transaction error occurs. param The object that will be the parameter to the onTxnErrorMethod() call. Side Effects Sets the values of ScobolLib.terminationStatus, ScobolLib.transactionId, and ScobolLib.restartCounter.
Class ServerReplyCode Java Import Package Reference Parameters sendItems An array of data items to be sent to the server serverclassName Identifies the server class for which the message is intended pathmonName Identifies the Pathmon process for which the server class is configured. If this value is not specified, the value is null. This parameter is optional; if the server class is monitored by the same Pathmon process as the gateway terminal, then this parameter is not necessary.
Class ServerReplyCode Java Import Package Reference Member Summary Constructor ServerReplyCode() Methods addReplyCode() Equivalent to the YIELDS clause of the SCREEN COBOL SEND statement Method Constructor Syntax public ServerReplyCode () Description Constructor for the ServerReplyCode class.
HTML Screen Interaction Classes Java Import Package Reference Method addReplyCode (Multiple Data Identifiers) Syntax public void addReplyCode (Integer replyCode, int terminationStatus, ScobolType[] identifier) Description Equivalent to the REPLY CODE reply-code-value YIELDS {identifier-2}... clause of the SCREEN COBOL SEND statement. This method is called once for each reply-code-value in the YIELDS clause. Parameters replyCode Equivalent to reply-code-value in the YIELDS clause of the SEND statement.
Class ScreenField Java Import Package Reference Description This interface class allows the API to treat objects of the classes ScreenField, ScreenFieldArray, and ScreenFieldGroup polymorphically. Class ScreenField The ScreenField class is the Java representation of the SCREEN COBOL screen fields. Package pathway.its Syntax public pathway.its.ScreenField implements ScreenFieldIdentifier Description This class provides methods to set the various attributes associated with a screen field.
Class ScreenField Java Import Package Reference Methods setADVISORY() Equivalent to the ADVISORY field-characteristic clause setCONTROLLEDBY() Equivalent to the CONTROLLED [BY] fieldcharacteristic clause setCONVERTBLANKS() Equivalent to the CONVERT BLANKS fieldcharacteristic clause setFILL() Equivalent to the FILL field-characteristic clause setInitAttribute() Sets the initial attributes of a screen field setLENGTH() Equivalent to the LENGTH [MUST BE] fieldcharacteristic clause setMUSTBE() Eq
Java Import Package Reference Class ScreenField Parameters name The value of the name attribute of the HTML control element. For example, for , name = new String ("WS-ITEM1"). from Corresponds to the data item in the FROM clause in the SCREEN COBOL field description. This parameter can be null. to Corresponds to the data item in the TO clause in the SCREEN COBOL field description. This parameter can be null.
Java Import Package Reference Class ScreenField Parameters controlObject Corresponds to data-name-1 in the CONTROLLED [BY] clause Method setCONVERTBLANKS Syntax public void setCONVERTBLANKS() Description Equivalent to the CONVERT BLANKS field-characteristic clause, as in: screen-field-name [AT] line-spec, column-spec PIC [IS] character-string USER [CONVERSION] numeric-literal CONVERT BLANKS Method setFILL Syntax public void setFILL (char fillChar) Description Equivalent to the FILL field-characterist
Java Import Package Reference Class ScreenField has the following Java equivalent: screenfieldObject.setInitAttribute (ScreenField.ATTR_PROTECTED | ScreenField.ATTR_MDTON) Parameters attribute Represents the initial screen-field attributes to be set at run time, constructed by bitwise ORing of the attribute literals to be set Method setLENGTH Syntax public void setLENGTH (int[] lengthArray) Description Equivalent to the LENGTH [MUST BE] field-characteristic clause.
Class ScreenField Java Import Package Reference has the following Java equivalent: String[] valueMustBe = {"10","20","HELLO","HELLO"}; screenfieldObject.setMUSTBE (valueMustBe); Parameters valueMustBe Corresponds to the literal-n values in the MUST [BE] clause. The array must be of the form {minVal1,maxVal1,minVal2, maxVal2,...}. Each maxValx must be >= minValx. If a value is to be discrete rather than a range, then set minValx and maxValx to the same discrete value.
Java Import Package Reference Class ScreenField Parameters Must be ScreenField.UPSHIFT_INPUT, ScreenField.UPSHIFT_OUTPUT, or ScreenField.
Java Import Package Reference Class ScreenFieldArray Method setWhenAbsent Syntax public void setWhenAbsent (int whenAbsent) Description Equivalent to the WHEN ABSENT field-characteristic clause, as in: screen-field-name [AT] line-spec, column-spec PIC [IS] character-string USING data-name-1 WHEN ABSENT { CLEAR | SKIP } Parameters whenAbsent Must be either CLEAR or SKIP Method setWhenBlank Syntax public void setWhenBlank (int whenBlank) Description Equivalent to the WHEN BLANK field-characteristic cla
Class ScreenFieldArray Java Import Package Reference Description This class implements the equivalent of the OCCURS field-characteristic clause. It is essentially a container for all the screen field objects that are part of an OCCURS clause.
Class ScreenFieldArray Java Import Package Reference Methods addField() Adds a screen field to the array setADVISORY() Equivalent to the ADVISORY field-characteristic clause setCONTROLLEDBY() Equivalent to the CONTROLLED [BY] fieldcharacteristic clause setCONVERTBLANKS() Equivalent to the CONVERT BLANKS fieldcharacteristic clause setFILL() Equivalent to the FILL field-characteristic clause setInitAttribute() Sets the initial attributes of the screen fields setLENGTH() Equivalent to the LENGTH
Java Import Package Reference Class ScreenFieldArray Parameters maxOccurs The value of columns-literal* lines-literal in the field-characteristic clause OCCURS IN columns-literal COLUMNS ON lines-literal LINES. dependingOn Corresponds to data-name-1 in the field-characteristic clause OCCURS IN columns-literal COLUMNS ON lines-literal LINES DEPENDING [ON] data-name-1. This parameter can be null.
Java Import Package Reference Class ScreenFieldArray Parameters controlObject Corresponds to data-name-1 in the CONTROLLED [BY] clause Method setCONVERTBLANKS Syntax public void setCONVERTBLANKS() Description Equivalent to the CONVERT BLANKS field-characteristic clause, as in: OCCURS IN columns-literal COLUMNS ON lines-literal LINES USER [CONVERSION] numeric-literal CONVERT BLANKS Method setFILL Syntax public void setFILL (char fillChar) Description Equivalent to the FILL field-characteristic clause,
Java Import Package Reference Class ScreenFieldArray has the following Java equivalent: screenfieldArrayObject.setInitAttribute (ScreenFieldArray.ATTR_PROTECTED | ScreenFieldArray.ATTR_MDTON) Parameters attribute Represents the initial screen-field attributes to be set at run time, constructed by bitwise ORing of the attribute literals to be set Method setLENGTH Syntax public void setLENGTH (int[] lengthArray) Description Equivalent to the LENGTH [MUST BE] field-characteristic clause.
Class ScreenFieldArray Java Import Package Reference has the following Java equivalent: String[] valueMustBe = {"10","20","HELLO","HELLO"}; screenfieldArrayObject.setMUSTBE (valueMustBe); Parameters valueMustBe Corresponds to the literal-n values in the MUST [BE] clause. The array must be of the form {minVal1,maxVal1,minVal2, maxVal2,...}. Each maxValx must be >= minValx. If a value is to be discrete rather than a range, then set minValx and maxValx to the same discrete value.
Java Import Package Reference Class ScreenFieldArray Parameters Must be ScreenFieldArray.UPSHIFT_INPUT, ScreenFieldArray.UPSHIFT_OUTPUT, or ScreenFieldArray.
Java Import Package Reference Class ScreenFieldGroup Method setWhenAbsent Syntax public void setWhenAbsent (int whenAbsent) Description Equivalent to the WHEN ABSENT field-characteristic clause, as in: OCCURS IN columns-literal COLUMNS ON lines-literal LINES USING data-name-1 WHEN ABSENT { CLEAR | SKIP } Parameters whenAbsent Must be either CLEAR or SKIP Method setWhenBlank Syntax public void setWhenBlank (int whenBlank) Description Equivalent to the WHEN BLANK field-characteristic clause, as in: OCC
Class ScreenFieldGroup Java Import Package Reference Member Summary Constructor ScreenFieldGroup() Methods addField() Adds a screen field to this object addFieldArray() Adds a screen field array (that is, a screen field associated with an OCCURS clause) to this object Method Constructor Syntax public ScreenFieldGroup () Description Constructs the equivalent of a SCREEN COBOL screen group.
Java Import Package Reference Class HTMLHandler Class HTMLHandler The HTMLHandler class encapsulates the SCREEN COBOL statements associated with displaying and accepting SCREEN COBOL screens. Examples of such statements are DISPLAY BASE, DISPLAY, and ACCEPT. Package pathway.its Syntax public pathway.its.HTMLHandler Description This class provides methods for rendering an HTML page as well as setting HTML field values and getting HTML field values from corresponding working-storage items.
Class HTMLHandler Java Import Package Reference UI Interaction Methods accept() Equivalent to the SCREEN COBOL ACCEPT statement clearInput() Equivalent to the SCREEN COBOL CLEAR INPUT statement display() Equivalent to the SCREEN COBOL DISPLAY statement displayBase() Equivalent to the SCREEN COBOL DISPLAY BASE statement displayOverlay() Equivalent to the SCREEN COBOL DISPLAY OVERLAY statement displayOverlaySpaces() Equivalent to the SCREEN COBOL DISPLAY OVERLAY SPACES AT statement resetAttribut
Class HTMLHandler Java Import Package Reference Syntax public void accept (ScreenFieldIdentifier[] fieldIds, FunctionKey[] untilFuncKeys, FunctionKey[] escFuncKeys public void accept (ScreenFieldIdentifier[] fieldIds, FunctionKey[] untilFuncKeys, FunctionKey[] escFuncKeys, int timeout, int timeoutTerminationStatus) Description The first form of the syntax is equivalent to the SCREEN COBOL statement: ACCEPT {screen-identifier}...
Java Import Package Reference Class HTMLHandler Method clearInput Purpose Clears the HTML field values. Syntax public void clearInput() Description Equivalent to the SCREEN COBOL CLEAR INPUT statement. Method display Purpose Displays the corresponding HTML field values for ScreenField objects.
Class HTMLHandler Java Import Package Reference Parameters fieldIDs An array of ScreenIdentifier objects; corresponds to screen-identifiers in the DISPLAY statement isTemporary If true, corresponds to the presence (and if false, to the absence) of the TEMP clause of the DISPLAY statement literal If non-null, corresponds to the presence (and if null, to the absence) of the IN clause of the DISPLAY statement dependingOn If non-null, corresponds to the presence (and if null, to the absence) of the DEP
Class HTMLHandler Java Import Package Reference Parameters htmlFilename The name of the HTML file to be displayed; for example, page.html. It is assumed that this HTML file is in the same directory as the HTML file containing the applet (cframe.html in the following example). formName The value of the NAME attribute in the
Class HTMLHandler Java Import Package Reference Description This method is equivalent to the SCREEN COBOL statement DISPLAY OVERLAY overlay-area-name. It must be called before calling display(). This method does not display an HTML page; the actual display is done during the call to display(). Parameters overlayScreenName The name of the HTML file that contains the overlay screen to be displayed overlayArea The name of the Overlay Area on the screen.
Class HTMLHandler Java Import Package Reference Method resetAttribute Purpose Resets the HTML field attributes for a selected number of fields.
Class HTMLHandler Java Import Package Reference Syntax public void resetData (ScreenFieldIdentifier[] fieldIds, boolean isTemporary) public void resetData (ScreenFieldIdentifier[] fieldIds, boolean isTemporary, ScobolType dependingOn) public void resetData (ScreenFieldIdentifier[] fieldIds, boolean isTemporary, boolean isShadowed) Description The first form of the syntax is equivalent to the SCREEN COBOL statement: RESET DATA {screen-identifier},...
Class HTMLHandler Java Import Package Reference Syntax public void setNewCursor (ScreenFieldIdentifier[] fieldIds) public void setNewCursor (ScreenFieldIdentifier[] fieldIds, ScobolType dependingOn) public void setNewCursor (ScreenFieldIdentifier[] fieldIds, boolean isShadowed) Description The first form of the syntax is equivalent to the SCREEN COBOL statement: SET NEW-CURSOR AT {screen-identifier},... The second form is equivalent to the SCREEN COBOL statement: SET NEW-CURSOR AT {screen-identifier},..
Class FunctionKey Java Import Package Reference public void turn (ScreenFieldIdentifier[] fieldIds, boolean isTemporary, int attrFlag, ScobolType dependingOn) public void turn (ScreenFieldIdentifier[] fieldIds, boolean isTemporary, int attrFlag, boolean isShadowed) Description The first form of the syntax is equivalent to the SCREEN COBOL statement: TURN [TEMP] {...} IN {screen-identifier},... The second form is equivalent to the SCREEN COBOL statement: TURN [TEMP] {...} IN {screen-identifier},...
Data-Type Classes Java Import Package Reference Description This class encapsulates the SCREEN COBOL function key settings. Member Summary Constructor FunctionKey() Method Constructor Syntax public FunctionKey (String keyLabel, int terminationStatusValue) Description Constructor for the FunctionKey class. Parameters keyLabel The literal that appears in the function-key dropdown box on the HTML page terminationStatusValue The value to which ScobolLib.
Class ScobolType Java Import Package Reference Member Summary Data Members public public public public public static static static static static final final final final final char char char char char HIGHVALUES LOWVALUES QUOTES SPACES ZEROS Constructor ScobolType() Abstract Methods getHostLength() Returns the number of bytes required to store the NonStop Kernel representation of the data getHostValue() Returns the NonStop Kernel representation of the data as a byte array setHostValue() Updates
Java Import Package Reference Class ScobolType Method getHostLength Purpose Returns the number of bytes required to store the NonStop Kernel representation of the data. Syntax public abstract int getHostLength() Return Value Returns the number of bytes required to represent the data item in the NonStop Kernel. Method getHostValue Purpose Returns the NonStop Kernel representation of the data as a byte array.
Java Import Package Reference Class ScobolType Parameters Corresponds to the NonStop Kernel byte representation of the data data Method isEqualTo (double data) Syntax public boolean isEqualTo (double data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] EQUAL [TO] noninteger-numeric-literal. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] equal to data, or FALSE otherwise.
Java Import Package Reference Class ScobolType Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] equal to data, or FALSE otherwise. Method isEqualTo (String data) Syntax public boolean isEqualTo (String data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] EQUAL [TO] string-literal.
Java Import Package Reference Class ScobolType Method isGreaterThan (double data) Syntax public boolean isGreaterThan (double data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] GREATER [THAN] noninteger-numeric-literal. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] greater than data, or FALSE otherwise.
Java Import Package Reference Class ScobolType Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] greater than data, or FALSE otherwise. Method isGreaterThan (String data) Syntax public boolean isGreaterThan (String data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] GREATER [THAN] string-literal.
Java Import Package Reference Class ScobolType Method isLessThan (double data) Syntax public boolean isLessThan (double data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] LESS [THAN] noninteger-numeric-literal. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] less than data, or FALSE otherwise.
Java Import Package Reference Class ScobolType Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] less than data, or FALSE otherwise. Method isLessThan (String data) Syntax public boolean isLessThan (String data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] LESS [THAN] string-literal.
Class ScobolGroupType Java Import Package Reference Method isValueNumeric Syntax public boolean isValueNumeric() Description Equivalent to the SCREEN COBOL class condition IS [NOT] NUMERIC. Return Value Returns TRUE if the value of this object is [not] numeric, or FALSE otherwise. Class ScobolGroupType Package pathway.its Syntax public abstract pathway.its.ScobolGroupType extends ScobolType Description This abstract class is the super-class for all SCREEN COBOL group data types implemented in Java.
Class ScobolGroupType Java Import Package Reference Non-Abstract Methods isValueAlphabetic() Equivalent to the SCREEN COBOL class condition IS [NOT] ALPHABETIC isValueNumeric() Equivalent to the SCREEN COBOL class condition IS [NOT] NUMERIC moveAll() Equivalent to the SCREEN COBOL MOVE ALL statement setHighValues() Equivalent to the SCREEN COBOL MOVE HIGHVALUES statement setLowValues() Equivalent to the SCREEN COBOL MOVE LOWVALUES statement setQuotes() Equivalent to the SCREEN COBOL MOVE QUOTES
Class ScobolGroupType Java Import Package Reference Parameters ScobolDataObject An object of type ScobolType in the group that that is being added. Example The following is an example SCREEN COBOL group data item: 01 CURRENT-TIME. 05 TIME-AT-START 05 DATE-AT-START 05 TIME-NOW PIC 9(8). PIC 9(8). PIC 9(8).
Java Import Package Reference Class ScobolGroupType Method getHostValue Purpose Returns the NonStop Kernel representation of the data as a byte array. Syntax public abstract byte [] getHostValue() Description The NonStop Kernel defines the data representation (bit pattern) for representing variables of a given type. The getHostValue() method returns the identical bit pattern, independent of its internal storage representation.
Java Import Package Reference Class ScobolGroupType Return Value Returns TRUE if the value of this object is [not] alphabetic, or FALSE otherwise. Method isValueNumeric Syntax public boolean isValueNumeric() Description Equivalent to the SCREEN COBOL class condition IS [NOT] NUMERIC. Return Value Returns TRUE if the value of this object is [not] numeric, or FALSE otherwise.
Java Import Package Reference Class ScobolGroupType Description Equivalent to the SCREEN COBOL statement MOVE LOW-VALUES TO group-item. Method setQuotes Syntax public void setQuotes() Description Equivalent to the SCREEN COBOL statement MOVE QUOTES TO group-item. Method setSpaces Syntax public void setSpaces() Description Equivalent to the SCREEN COBOL statement MOVE SPACES TO group-item.
Java Import Package Reference Class ScobolGroupType Parameters The data used to set the value of this object data Method setValue (ScobolType data) Syntax public void setValue (ScobolType data) Description Equivalent to the SCREEN COBOL statement MOVE data-name-1 TO group-2, where data-name-1 is the parameter to this method and group-2 is this object.
Class Pic9 Java Import Package Reference Class Pic9 Package pathway.its Syntax public pathway.its.Pic9 extends ScobolType Description This class is the Java representation of the SCREEN COBOL numeric integer (both computational and display) data types. SCREEN COBOL numeric integer data types are those that are described by the PIC 9 clauses.
Class Pic9 Java Import Package Reference Class-Specific Methods getValue() Returns the value in native Java type isEqualTo() Equivalent to the SCREEN COBOL relation condition IS [NOT] EQUAL [TO] isGreaterThan() Equivalent to the SCREEN COBOL relation condition IS [NOT] GREATER [THAN] isLessThan() Equivalent to the SCREEN COBOL relation condition IS [NOT] LESS [THAN] isValueNumeric() Equivalent to the SCREEN COBOL class condition IS [NOT] NUMERIC setValue() Equivalent to the SCREEN COBOL stateme
Class Pic9 Java Import Package Reference Parameters numDigits The number of digits in the integer; must be between 1 and 18, inclusive computational Must be either Pic9.COMP or Pic9.DISPLAY signed Must be either Pic9.SIGNED or Pic9.UNSIGNED Method Constructor (Sign Leading or Trailing) Syntax public Pic9 (int numDigits, int signFlag) Description This form is used to construct the following SCREEN COBOL types: SCREEN COBOL Type Java Type PIC S9(n) sign lead new Pic9 (n, Pic9.
Java Import Package Reference Class Pic9 Return Value Returns the number of bytes required to represent the equivalent SCREEN COBOL data item in the NonStop Kernel. Method getHostValue Purpose Returns the NonStop Kernel representation of the data as a byte array. Syntax public byte [] getHostValue() Description The byte array does not necessarily represent an actual numeric item. Any arbitrary byte pattern can be stored in this object with the setHostValue() method.
Java Import Package Reference Class Pic9 Parameters The byte array whose contents will be the new value of this object. The length of the array must be greater than or equal to getHostLength(). data Method getValue Syntax public long getValue() Description If the object is non-computational, the byte contents must be ASCII 0 through ASCII 9 (except for the sign byte). Return Value Returns the numeric value stored in the object.
Java Import Package Reference Class Pic9 Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] equal to data, or FALSE otherwise. Method isEqualTo (ScobolType data) Syntax public boolean isEqualTo (ScobolType data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] EQUAL [TO] ws-item-2, where ws-item-1 is a PIC 9 identifier.
Java Import Package Reference Class Pic9 Method isGreaterThan (double data) Syntax public boolean isGreaterThan (double data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] GREATER [THAN] noninteger-numeric-literal, where ws-item-1 is a PIC 9 identifier. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] greater than data, or FALSE otherwise.
Java Import Package Reference Class Pic9 Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] greater than data, or FALSE otherwise. Method isGreaterThan (String data) Syntax public boolean isGreaterThan (String data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] GREATER [THAN] string-literal, where ws-item-1 is a PIC 9 identifier.
Java Import Package Reference Class Pic9 Method isLessThan (long data) Syntax public boolean isLessThan (long data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] LESS [THAN] integer-numeric-literal, where ws-item-1 is a PIC 9 identifier. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] less than data, or FALSE otherwise.
Java Import Package Reference Class Pic9 Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] less than data, or FALSE otherwise. Method isValueNumeric Syntax public boolean isValueNumeric() Description Equivalent to the SCREEN COBOL class condition IS [NOT] NUMERIC. Return Value Returns TRUE if the value of this object is [not] numeric, or FALSE otherwise.
Java Import Package Reference Class Pic9 Parameters The data used to set the value of this object data Method setValue (Pic9 data) Syntax public void setValue (Pic9 data) Description Equivalent to the SCREEN COBOL statement MOVE ws-item-src TO wsitem-dest, where both ws-item-src and ws-item-dest are PIC 9 identifiers.
Java Import Package Reference Class Pic9 Parameters The data used to set the value of this object data Method setValue (PicX data) Syntax public void setValue (PicX data) Description Equivalent to the SCREEN COBOL statement MOVE ws-item-src TO ws-item-dest, where ws-item-src is a PIC X identifier and ws-item-dest is a PIC 9 identifier.
Class Pic9P Java Import Package Reference Parameters The data used to set the value of this object data Method setZeroes Syntax public void setZeroes() Description Equivalent to the SCREEN COBOL statement MOVE ZEROS TO data-name-1, where data-name-1 is this object. Class Pic9P Package pathway.its Syntax public pathway.its.
Class Pic9P Java Import Package Reference Class-Specific Methods getValue() Returns the value in native Java type isEqualTo() Equivalent to the SCREEN COBOL relation condition IS [NOT] EQUAL [TO] isGreaterThan() Equivalent to the SCREEN COBOL relation condition IS [NOT] GREATER [THAN] isLessThan() Equivalent to the SCREEN COBOL relation condition IS [NOT] LESS [THAN] isValueNumeric() Equivalent to the SCREEN COBOL class condition IS [NOT] NUMERIC setValue() Equivalent to the SCREEN COBOL statem
Class Pic9P Java Import Package Reference SCREEN COBOL Type Java Type PIC S9(m)P(n) new Pic9P (m, n, Pic9P.DISPLAY, Pic9P.SIGNED) PIC P(n)9(m) COMP new Pic9P (m, -(m+n), Pic9P.COMP, Pic9P.UNSIGNED) PIC SP(n)9(m) COMP new Pic9P (m, -(m+n), Pic9P.COMP, Pic9P.SIGNED) PIC P(n)9(m) new Pic9P (m, -(m+n), Pic9P.DISPLAY, Pic9P.UNSIGNED) PIC SP(n)9(m) new Pic9P (m, -(m+n), Pic9P.DISPLAY, Pic9P.
Class Pic9P Java Import Package Reference SCREEN COBOL Type Java Type PIC SP(n)9(m) sign trail new Pic9P (m, -(m+n), Pic9P.SIGNTRAILING) PIC SP(n)9(m) sign lead separate new Pic9P (m, -(m+n), Pic9P.SIGNLEADINGSEPARATE) PIC SP(n)9(m) sign trail separate new Pic9P (m, -(m+n), Pic9P.
Java Import Package Reference Class Pic9P setValue(double data) is used to set this object, the byte array will be a replica of the byte array used to represent the same numeric value in the NonStop Kernel. The length of the returned byte array will be the same as that returned by getHostLength(). Return Value Returns the byte array used to represent the numeric value in the NonStop Kernel. Method setHostValue Purpose Updates the value of the object with the given byte array.
Java Import Package Reference Class Pic9P Method isEqualTo (double data) Syntax public boolean isEqualTo (double data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] EQUAL [TO] noninteger-numeric-literal, where ws-item-1 is a PIC 9P identifier. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] equal to data, or FALSE otherwise.
Java Import Package Reference Class Pic9P Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] equal to data, or FALSE otherwise. Method isEqualTo (String data) Syntax public boolean isEqualTo (String data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] EQUAL [TO] string-literal, where ws-item-1 is a PIC 9P identifier.
Java Import Package Reference Class Pic9P Method isGreaterThan (long data) Syntax public boolean isGreaterThan (long data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] GREATER [THAN] integer-numeric-literal, where ws-item-1 is a PIC 9P identifier. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] greater than data, or FALSE otherwise.
Java Import Package Reference Class Pic9P Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] greater than data, or FALSE otherwise. Method isLessThan (double data) Syntax public boolean isLessThan (double data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] LESS [THAN] noninteger-numeric-literal, where ws-item-1 is a PIC 9P identifier.
Java Import Package Reference Class Pic9P Method isLessThan (ScobolType data) Syntax public boolean isLessThan (ScobolType data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] LESS [THAN] ws-item-2, where ws-item-1 is a PIC 9P identifier. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] less than data, or FALSE otherwise.
Java Import Package Reference Class Pic9P Method setValue (double data) Syntax public void setValue (double data) Description Equivalent to the SCREEN COBOL statement MOVE noninteger-numericliteral TO ws-item, where ws-item is a PIC 9P identifier.
Java Import Package Reference Class Pic9P Method setValue (Pic9V data) Syntax public void setValue (Pic9V data) Description Equivalent to the SCREEN COBOL statement MOVE ws-item-src TO wsitem-dest, where ws-item-src is a PIC 9V identifier and ws-item-dest is a PIC 9P identifier.
Class Pic9V Java Import Package Reference Method setZeroes Syntax public void setZeroes() Description Equivalent to the SCREEN COBOL statement MOVE ZEROS TO data-name-1, where data-name-1 is this object. Class Pic9V Package pathway.its Syntax public pathway.its.Pic9V extends ScobolType Description This class is the Java representation of the SCREEN COBOL numeric real data types (both computational and display). SCREEN COBOL numeric real data types are those that are described by the PIC 9V clauses.
Class Pic9V Java Import Package Reference Class-Specific Methods getValue() Returns the value in native Java type isEqualTo() Equivalent to the SCREEN COBOL relation condition IS [NOT] EQUAL [TO] isGreaterThan() Equivalent to the SCREEN COBOL relation condition IS [NOT] GREATER [THAN] isLessThan() Equivalent to the SCREEN COBOL relation condition IS [NOT] LESS [THAN] isValueNumeric() Equivalent to the SCREEN COBOL class condition IS [NOT] NUMERIC setValue() Equivalent to the statement MOVE data
Class Pic9V Java Import Package Reference SCREEN COBOL Type Java Type PIC S9(m)V9(n) COMP new Pic9V (m, n, Pic9V.COMP, Pic9V.SIGNED) PIC 9(m)V9(n) new Pic9V (m, n, Pic9V.DISPLAY, Pic9V.UNSIGNED) PIC S9(m)V9(n) new Pic9V (m, n, Pic9V.DISPLAY, Pic9V.
Class Pic9V Java Import Package Reference Parameters numIntegerDigits The number of digits in the integer portion of the number; must be between 0 and 16, inclusive numFractionDigits The number of digits in the fractional portion of the number; must be between 0 and 16, inclusive; the sum of numIntegerDigits and numFractionDigits must be between 1 and 16, inclusive signFlag Must be one of Pic9V.SIGNLEADING, Pic9V.SIGNTRAILING, Pic9V.SIGNLEADINGSEPARATE, or Pic9V.
Java Import Package Reference Class Pic9V Return Value Returns the byte array used to represent the numeric value in the NonStop Kernel. Method setHostValue Purpose Updates the value of the object with the given byte array. Syntax public void setHostValue (byte[] data) Description This method is used to store a byte pattern in this object. Whether the byte array represents a valid numeric value is not verified.
Java Import Package Reference Class Pic9V Method isEqualTo (double data) Syntax public boolean isEqualTo (double data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] EQUAL [TO] noninteger-numeric-literal, where ws-item-1 is a PIC 9V identifier. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] equal to data, or FALSE otherwise.
Java Import Package Reference Class Pic9V Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] equal to data, or FALSE otherwise. Method isEqualTo (String data) Syntax public boolean isEqualTo (String data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] EQUAL [TO] string-literal, where ws-item-1 is a PIC 9V identifier.
Java Import Package Reference Class Pic9V Method isGreaterThan (long data) Syntax public boolean isGreaterThan (long data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] GREATER [THAN] integer-numeric-literal, where ws-item-1 is a PIC 9V identifier. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] greater than data, or FALSE otherwise.
Java Import Package Reference Class Pic9V Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] greater than data, or FALSE otherwise. Method isLessThan (double data) Syntax public boolean isLessThan (double data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] LESS [THAN] noninteger-numeric-literal, where ws-item-1 is a PIC 9V identifier.
Java Import Package Reference Class Pic9V Method isLessThan (ScobolType data) Syntax public boolean isLessThan (ScobolType data) Description Equivalent to the SCREEN COBOL relation condition ws-item-1 IS [NOT] LESS [THAN] ws-item-2, where ws-item-1 is a PIC 9V identifier. Parameters The value to be compared with the value of this object data Return Value Returns TRUE if the value of this object is [not] less than data, or FALSE otherwise.
Java Import Package Reference Class Pic9V Method setValue (double data) Syntax public void setValue (double data) Description Equivalent to the SCREEN COBOL statement MOVE noninteger-numericliteral TO ws-item, where ws-item is a PIC 9V identifier.
Java Import Package Reference Class Pic9V Method setValue (Pic9V data) Syntax public void setValue (Pic9V data) Description Equivalent to the SCREEN COBOL statement MOVE ws-item-src TO wsitem-dest, where both ws-item-src and ws-item-dest are PIC 9V identifiers.
Java Import Package Reference Class PicN Method setValue (String data) Syntax public void setValue (String data) Description Equivalent to the SCREEN COBOL statement MOVE string-literal TO ws-item, where ws-item is a PIC 9V identifier. Parameters The data used to set the value of this object data Method setZeroes Syntax public void setZeroes() Description Equivalent to the SCREEN COBOL statement MOVE ZEROS TO data-name-1, where data-name-1 is this object. Class PicN Package pathway.
Class PicN Java Import Package Reference Abstract Method Implementation getHostLength() Returns the number of bytes required to store the NonStop Kernel representation of the data getHostValue() Returns the NonStop Kernel representation of the data as a byte array setHostValue() Updates the value of the object with the given byte array Class-Specific Methods getValue() Returns the value in native Java type isDoubleByte() Equivalent to the SCREEN COBOL clause IS [NOT] DOUBLEBYTE in the IF ...
Class PicN Java Import Package Reference Method Constructor (Justification Specified) Syntax public PicN (int size, boolean justification) Description Upon construction, the object will contain blanks. Parameters size The number of double-byte characters this object can hold justification Must be either PicN.LEFTJUSTIFIED or PicN.RIGHTJUSTIFIED Method Constructor (Initialized Data, Left-Justified) Syntax public PicN (int size, String data) Description In this form, data is left justified.
Class PicN Java Import Package Reference Parameters size The number of double-byte characters this object can hold justification Must be either PicN.LEFTJUSTIFIED or PicN.RIGHTJUSTIFIED data The initial value for this object Method getHostLength Purpose Returns the number of bytes required to store the NonStop Kernel representation of the data.
Java Import Package Reference Class PicN Method setHostValue Purpose Updates the value of the object with the given byte array. Syntax public void setHostValue (byte[] data) Description This method is used to store a byte pattern in this object. Parameters The byte array whose contents will be the new value of this object. The length of the array must be greater than or equal to getHostLength(). data Method getValue Syntax public String getValue() Return Value Returns the object as a Java string.
Java Import Package Reference Class PicN Method moveAll Syntax public void moveAll (String str) Description Equivalent to the SCREEN COBOL statement MOVE ALL string-literal TO ws-item, where ws-item is a PIC N identifier. Parameters The string literal to be moved into this object str Method setSpaces Syntax public void setSpaces() Description Equivalent to the SCREEN COBOL statement MOVE SPACES TO ws-item, where ws-item is a PIC N identifier.
Java Import Package Reference Class PicX a PIC N identifier. The PIC X identifier can contain a combination of double-byte and single-byte characters. Parameters The data used to set the value of this object data Method setValue (ScobolGroupType data) Syntax public void setValue (ScobolGroupType data) Description Equivalent to the SCREEN COBOL statement MOVE ws-group-item TO ws-item-dest, where ws-group-item is a group item identifier and ws-item-dest is a PIC N identifier.
Class PicX Java Import Package Reference Member Summary Constructor PicX() Abstract Method Implementation getHostLength() Returns the number of bytes required to store the NonStop Kernel representation of the data getHostValue() Returns the NonStop Kernel representation of the data as a byte array setHostValue() Updates the value of the object with the given byte array Class-Specific Methods getValue() Returns the value in native Java type isDoubleByte() Equivalent to the SCREEN COBOL clause IS
Class PicX Java Import Package Reference Method Constructor Syntax public PicX (int size) Description In this form, data is left-justified. Upon construction, the object will contain blanks. Parameters The number of characters this object can hold size Method Constructor (Justification Specified) Syntax public PicX (int size, boolean justification) Description Upon construction, the object will contain blanks.
Class PicX Java Import Package Reference Parameters size The number of characters this object can hold data The initial value for this object Method Constructor (Initialized Data, Justification Specified) Syntax public PicX (int size, boolean justification, String data) Description If the number of characters is less than the specified size, the data will be padded with blanks in accordance with SCREEN COBOL rules.
Java Import Package Reference Class PicX Description The length of the returned byte array will be the same as that returned by getHostLength(). Return Value Returns the byte array used to represent the alphanumeric value in the NonStop Kernel. Method setHostValue Purpose Updates the value of the object with the given byte array. Syntax public void setHostValue (byte[] data) Description This method is used to store a byte pattern in this object.
Java Import Package Reference Class PicX Return Value Returns TRUE if all the characters in this object are double-byte characters, or FALSE if at least one of them is a single-byte character. If negated, returns FALSE if all the characters in this object are double-byte characters, or TRUE if at least one of them is a single-byte character. Method isValueAlphabetic Syntax public boolean isValueAlphabetic() Description Equivalent to the SCREEN COBOL class condition IS [NOT] ALPHABETIC.
Java Import Package Reference Class PicX Parameters The string literal to be moved into this object s Method setHighValues Syntax public void setHighValues() Description Equivalent to the SCREEN COBOL statement MOVE HIGH-VALUES TO ws-item, where ws-item is a PIC X identifier. Method setLowValues Syntax public void setLowValues() Description Equivalent to the SCREEN COBOL statement MOVE LOW-VALUES TO ws-item, where ws-item is a PIC X identifier.
Java Import Package Reference Class PicX Method setValue (double data) Syntax public void setValue (double data) Description Equivalent to the SCREEN COBOL statement MOVE noninteger-literal TO ws-item, where ws-item is a PIC X identifier. Parameters The data used to set the value of this object data Method setValue (long data) Syntax public void setValue (long data) Description Equivalent to the SCREEN COBOL statement MOVE integer-literal TO ws-item, where ws-item is a PIC X identifier.
Java Import Package Reference Class PicX Description Equivalent to the SCREEN COBOL statement MOVE ws-item-src TO ws-item-dest, where ws-item-src is a PIC 9P identifier and ws-item-dest is a PIC X identifier.
Java Import Package Reference Transform Class Description Equivalent to the SCREEN COBOL statement MOVE ws-group-item TO ws-item-dest, where ws-group-item is a group item identifier and ws-item-dest is a PIC X identifier. Parameters The data used to set the value of this object data Method setValue (String data) Syntax public void setValue (String data) Description Equivalent to the SCREEN COBOL statement MOVE string-literal TO ws-item, where ws-item is a PIC X identifier.
Class Transform Java Import Package Reference Description This class implements the SCREEN COBOL TRANSFORM statement. Member Summary Constructor Transform() Methods doTransform() Implements the TRANSFORM statement yields() Equivalent to the YIELDS clause of the TRANSFORM statement Method Constructor (no select code field) Syntax public Transform (ScobolType[] inRec) Description This form instantiates an object to implement a TRANSFORM statement without the SELECT CODE FIELD [IS] clause.
Class Transform Java Import Package Reference Parameters inRec An array of ScobolType objects, each of which corresponds to a working-storage item specified in trans-rec-out in the TRANSFORM statement selectCode The ScobolType object corresponding to the working-storage item specified in the SELECT CODE FIELD [IS] clause in the TRANSFORM statement offset Indicates the position of the selectCode value within trans-rec-out in the TRANSFORM statement Method doTransform Syntax public void doTransform()
Class Transform Java Import Package Reference where the select-code value is specified as an integer depending on the business logic. This form instantiates a Pic9 object as the code-field. This method is called once for each select-code value in the YIELDS clause.
ProgramUnit Class Java Import Package Reference where the select-code value is specified as a working-storage item. This form instantiates a ScobolType object as the code-field. This method is called once for each select-code value in the YIELDS clause.
Class ProgramUnit Java Import Package Reference Member Summary Data Members public static final char COMMA Represents the character ',' public PicX diagnosticAllowed Equivalent to the DIAGNOSTICALLOWED special register public static final char PERIOD Represents the character '.
Class ProgramUnit Java Import Package Reference Method getNewOverlayManager Syntax public OverlayManager getNewOverlayManager (String baseHTMLFileName) Description Obtains a handle to an OverlayManager object that is local to this program unit. Parameters baseHTMLFileName The file name of the HTML page that corresponds to the base screen Return Value Returns a handle to an object of type OverlayManager. Method setCurrencySign Purpose Sets the character to be used as the currency symbol.
Java Import Package Reference Special-Register Classes Parameters decimalChar The character that is to represent the decimal point Method stopRun Syntax public void [] stopRun() throws StopRunException Description Equivalent to the SCREEN COBOL statement STOP RUN. Special-Register Classes The special-register classes define the Java equivalents of the SCREEN COBOL special registers, plus five additional special registers to support user profiles in converted web clients.
Class ScobolLib Java Import Package Reference Member Summary Data Members public public public public public public public public public public public public public public public public public public public public public public public public public static static static static static static static static static static static static static static static static static static static static static static static static static final int final int PicX Cursor Cursor PicX PicX PicX PicX PicX PicX PicX PicX Pic9
Class ScobolLib Java Import Package Reference Description Equivalent to the SCREEN COBOL DELAY statement. Parameters The value to delay, in seconds delayTime Method setCharSet Purpose Specifies the character set. Syntax public static void setCharSet (int charSetValue) Description Equivalent to the SCREEN COBOL CHARACTER-SET IS statement in the OBJECTCOMPUTER paragraph of the Environment Division.
Class Cursor Java Import Package Reference Parameters operand1 The first operand in the intermediate operation of exponentiation. operand2 The second operand; an integer. Class Cursor Package pathway.its Syntax public pathway.its.Cursor extends ScobolType Description This abstract class is the Java representation of the SCREEN COBOL special registers NEW-CURSOR and OLD-CURSOR.
Java Import Package Reference Class Cursor Method Constructor Syntax public Cursor() Method getHostLength Purpose Returns the number of bytes required to store the NonStop Kernel representation of the data. Syntax public int getHostLength() Return Value Returns the number of bytes required to represent the equivalent SCREEN COBOL data item in the NonStop Kernel. Method getHostValue Purpose Returns the NonStop Kernel representation of the data as a byte array.
Java Import Package Reference Exception Classes Description This method is used to store a byte pattern in this object. Parameters The byte array whose contents will be the new value of this object. The length of the array must be greater than or equal to getHostLength(). data Method initialize Purpose Sets the values of the cursorRow and cursorCol objects to zeros. Syntax public void initialize() Description Equivalent to the SCREEN COBOL statement MOVE ZEROS TO NEW-CURSOR or MOVE ZEROS TO OLD-CURSOR.
Class ScobolException Java Import Package Reference Method Constructor Syntax public ExitProgramException() Class ScobolException Package pathway.its Syntax public pathway.its.ScobolException extends java.lang.RuntimeException Description This class represents the exception that is thrown when an unrecoverable error is encountered. In general, this exception is thrown in cases where the terminal executing the SCREEN COBOL program would be suspended.
Class ScobolSendException Java Import Package Reference Method Constructor (String argument) Syntax public ScobolException (String exceptionString) Parameters exceptionString A string that is passed to the parent class (RuntimeException) and is then available through a call to toString() Class ScobolSendException Package pathway.its Syntax public pathway.its.ScobolSendException extends java.lang.
Class ScobolTxnException Java Import Package Reference Method Constructor (String argument) Syntax public ScobolSendException (String exceptionString) Parameters exceptionString A string that is passed to the parent class (Exception) and is then available through a call to toString() Class ScobolTxnException Package pathway.its Syntax public pathway.its.ScobolTxnException extends java.lang.
Java Import Package Reference Class TransformException Description This class represents the exception that is thrown when an error is encountered during processing of a STOP RUN statement. Member Summary Constructor StopRunException() Method Constructor Syntax public StopRunException() Class TransformException Package pathway.its Syntax public pathway.its.
User Conversion Classes Java Import Package Reference User Conversion Classes The user conversion classes define the Java equivalent of the standard user conversion routines in PATHTCPL. Class UserConversion Package pathway.its Syntax public interface pathway.its.UserConversion Description This interface class is used by the ScLibUserConversion class.
Class ScLibUserConversion Java Import Package Reference Method doInputUserConversion Syntax public boolean doInputUserConversion (ScreenField[] fldArray) Parameters fldArray An array of ScreenField objects for which user conversion is to be done; corresponds to screen fields having the USER CONVERSION clause in SCREEN COBOL Description This method is automatically invoked during execution of the accept() method. It is called before the data is moved from the screen fields to the associated TO objects.
Class ScLibUserConversion Java Import Package Reference Description This class provides the Java equivalent of the standard user conversion routines provided in the TCP user library object file, PATHTCPL.
Class ScLibUserConversion Java Import Package Reference Parameters fldArray An array of ScreenField objects for which user conversion is to be done; corresponds to screen fields having the USER CONVERSION clause in SCREEN COBOL Description This method is automatically invoked during execution of the accept() method. It is called before the data is moved from the screen fields to the associated TO objects.
Java Import Package Reference Class ScLibUserConversion Compaq NonStop Pathway/iTS Web Client Programming Manual— 520270-001 6 -126
A Client Error Messages This appendix describes the pop-up messages that end users can receive while running a Pathway/iTS web client. General Information Messages with numbers in the range 3000 through 3299 are analogous to the corresponding, same-numbered terminal control process (TCP) messages issued when screen programs are running on the NonStop Himalaya system. These messages are generated by the Pathway/iTS gateway threads and passed to the Java applet portion of the web client.
Client Error Messages Message Descriptions 3003 *3003* INVALID SUBSCRIPT VALUE error-loc Cause. The value of a subscript expression was either zero or larger than the limit implied by the OCCURS clause. Effect. The applet stops. Recovery. Isolate and correct the problem within the Java program, using the stack trace information in error-loc to locate the problem. Alternatively, correct the problem in the SCREEN COBOL program and reconvert the application.
Client Error Messages Message Descriptions 3007 *3007* SCREEN OPERATION DONE WITHOUT BASE DISPLAYED error-loc Cause. A screen-manipulation operation was attempted before a DISPLAY BASE statement was executed. Effect. The applet stops. Recovery. Isolate and correct the problem within the Java program, using the stack trace information in error-loc to locate the problem. Alternatively, correct the problem in the SCREEN COBOL program and reconvert the application.
Client Error Messages Message Descriptions 3020 *3020* CALLED PROGRAM UNIT NOT FOUND error-loc Cause. The program unit specified in a CALL statement was not found in the TCLPROG files. Effect. The operation fails. Recovery. Isolate and correct the problem within the Java program, using the stack trace information in error-loc to locate the problem. Alternatively, correct the problem in the SCREEN COBOL program and reconvert the application. 3022 *3022* SEND: SERVER CLASS NAME INVALID error-loc Cause.
Client Error Messages Message Descriptions Recovery. Either configure TMF auditing or isolate and correct the problem within the Java program, using the stack trace information in error-loc to locate the problem. Alternatively, correct the problem in the SCREEN COBOL program and reconvert the application. 3031 *3031* TMF NOT RUNNING error-loc Cause. An attempt to use the Transaction Management Facility (TMF) failed because the TMF software was not running on the host NonStop Himalaya system. Effect.
Client Error Messages Message Descriptions 3049 *3049* EXIT PROGRAM ENCOUNTERED error-loc Cause. The applet stopped because it encountered an exit through an EXIT PROGRAM statement in the highest-level (main) program unit. Effect. The applet stops. Recovery. Informational message only; no corrective action is needed. 3052 *3052* TERMINAL STOPPED BY PROGRAM error-loc Cause. The applet stopped because it encountered an exit through a STOP RUN statement in the highest-level (main) program unit. Effect.
Client Error Messages Message Descriptions 3072 *3072* RUN-TIME DYNAMIC ATTRIBUTE SETTING INVALID error-loc Cause. An illegal attribute setting was detected, or the specified attribute setting would cause an out-of-bounds condition to occur during the run-time processing of the control structure. Effect. The applet stops. Recovery. Isolate and correct the problem within the Java program, using the stack trace information in error-loc to locate the problem.
Client Error Messages Message Descriptions 3113 *3113* TRANSACTION MESSAGE SIZE EXCEEDS LIMIT error-loc Cause. The size of a message for a SEND operation to a server exceeded that allowed by the SERVERPOOL attribute in the terminal control process (TCP) configuration. Effect. The operation fails. Recovery. Redefine the value of the SERVERPOOL attribute, or isolate and correct the problem within the Java program, and restart the application.
Client Error Messages Message Descriptions Recovery. Isolate and correct the problem within the Java program, using the stack trace information in error-loc to locate the problem. Alternatively, correct the problem in the SCREEN COBOL program and reconvert the application. 3118 *3118* REQUEST INVALID FOR SERVER STATE error-loc Cause. The state of the specified server did not allow the requested operation to occur. The server might have been frozen, or an internal error might have occurred. Effect.
Client Error Messages Message Descriptions Recovery. Isolate and correct the problem within the Java program, using the stack trace information in error-loc to locate the problem. Alternatively, remove the unsupported function from the SCREEN COBOL program and reconvert the application. 3179 *3179* DATA LEFT OVER ON SCATTER TO WORKING STORAGE error-loc Cause. A program unit attempted to execute a TRANSFORM operation, but there was data left unprocessed from the source data stream. Effect.
Client Error Messages Message Descriptions 3300 *3300* CONNECTION NOT ESTABLISHED WITH GATEWAY REQUESTER THREAD error-loc Cause. The TCP/IP socket connection was not established by invoking the GatewayInitateConnection class before sending a request to the terminal control process (TCP). Effect. The applet stops. Recovery. Isolate and correct the problem within the Java program, using the stack trace information in error-loc to locate the problem.
Client Error Messages Message Descriptions 3303 *3303* THE ON ERROR METHOD OF BEGIN-TRANSACTION IS NOT PUBLIC error-loc Cause. The method OnTxnErrorMethod, which implements the ON ERROR clause of the BEGIN-TRANSACTION statement in the SCREEN COBOL program, is not a public method. Effect. The applet stops. Recovery. Isolate and correct the problem within the Java program, using the stack trace information in error-loc to locate the problem.
Client Error Messages Message Descriptions 3307 *3307* FATAL ERROR DURING BEGIN TRANSACTION error-loc Cause. A fatal error occurred while the terminal control process (TCP) was attempting to start a transaction. Effect. If the ON ERROR clause of the BEGIN-TRANSACTION statement is present in the SCREEN COBOL source code—that is, if the onTxnErrorMethod method is present in the Java code—then the ON ERROR branch is taken. Otherwise, the applet stops. Recovery.
Client Error Messages Message Descriptions Compaq NonStop Pathway/iTS Web Client Programming Manual— 520270-001 A -14
B SCREEN COBOL Features Not Supported for Web Conversion Certain SCREEN COBOL features are either not supported for conversion to web clients or have a modified representation in the converted code. In some cases, this is because the features are not applicable in a web environment or because of limitations imposed by Java. Table B-1 lists the SCREEN COBOL statements and clauses that are not supported or have limited support for conversion.
SCREEN COBOL Features Not Supported for Web Conversion Table B-1. Web Conversion Support Limitations (page 2 of 4) SCREEN COBOL Feature Converter Action Recommended Corrective Action DYNAMIC Dynamic changes of attributes are not supported. The converter generates equivalent calls that do nothing. Dynamic attributes depend on the browser. Modify the converted code based on the browsers to be used.
SCREEN COBOL Features Not Supported for Web Conversion Table B-1. Web Conversion Support Limitations (page 3 of 4) SCREEN COBOL Feature Converter Action Recommended Corrective Action RECONNECT MODEM Because the converted application is running within the context of a browser and not over a dial-up ine, this statement is not meaningful in a web environment. The converter generates a warning and continues converting the rest of the program.
SCREEN COBOL Features Not Supported for Web Conversion Table B-1. Web Conversion Support Limitations (page 4 of 4) SCREEN COBOL Feature Converter Action Recommended Corrective Action TERMINAL IS unsupported-type Conversion is supported only for program units with terminal types T16-6520, T16-6530, T16-6540, and IBM-3270. The converter generates an error and continues converting the rest of the program. The converted Java code contains a non-compilable statement. The program unit cannot be converted.
Index A abortTransaction method 6-3 ABORT-TRANSACTION statement, Java implementation of 6-3 abstract class for actions applying to program units 6-109 for NEW-CURSOR and OLD-CURSOR special registers 6-115 for SCREEN COBOL data types 6-38 for SCREEN COBOL group data types 6-47 ACCEPT DATE statement, Java implementation of 6-4 ACCEPT DAY statement, Java implementation of 6-4 accept method 6-28 ACCEPT statement, Java implementation of 5-6, 6-28 ACCEPT TIME statement, Java implementation of 6-4 acceptDate metho
D Index communications protocols supported by router process 1-4 compiling a converted application OSS environment 2-8 Windows environment 2-9 computational data types, Java implementation of integer 6-54 noninteger 6-66, 6-78 real 6-78 configuration file, for converting SCREEN COBOL programs 2-2 configuring Pathway applications with web clients 1-1 user conversion server class 4-2 user profile server class 3-6 Connection not established with gateway… (message 3300) A-11 constructor for Cursor class 6-116
E Index data members (continued) in ScreenField class 6-10 in ScreenFieldArray class 6-18 database for user profiles 3-2 data-type classes 6-38 decimal point character, setting 6-111 delay method 6-113 delaying program execution 6-113 DEPENDING variable value too big (message 3002) A-1 deploying web clients OSS environment 2-9 Windows environment 2-11 developing web clients diagram 1-1/1-2 steps in process 2-1/2-17 DEVICEINFO statement, not supported B-1 display data types, Java implementation of integer
F Index F Fatal error during BEGIN TRANSACTION (message 3307) A-13 Field contains other than DBCS data (message 3068) A-6 FILL clause, Java implementation of 6-13, 6-21 Function unimplemented (message 3203) A-10 FunctionKey class constructor 6-38 details 6-37 G Gateway class constructor 6-3 details 6-2 methods 6-3 use of by converter 5-5 gateway program illustrated 1-2 role of, in supporting web clients 1-5 getHostLength method in Cursor class 6-116 in Pic9 class 6-56 in Pic9P class 6-69 in Pic9V class 6
I Index import package See Java import package for web clients initial attributes of screen field, setting 6-13, 6-21 initial page, HTML 5-2 initialize method, in Cursor class 6-117 input user conversion methods, Java implementation of 6-123, 6-124 input-output elements, mapping to ScreenField objects 5-6 Integer data types, Java implementation of 6-54 Intelligent Device Support (IDS), not supported B-3 Intelligent Device Support (IDS), not supported for web clients 1-1 interface class for screen field id
J Index isLessThan method in Pic9 class 6-61 in Pic9P class 6-74 in Pic9V class 6-86 in ScobolType class 6-45 isLessThanAll method 6-46 isValueAlphabetic method in PicX class 6-101 in ScobolGroupType class 6-50 isValueNumeric method in Pic9 class 6-63 in Pic9P class 6-75 in Pic9V class 6-87 in PicX class 6-101 in ScobolGroupType class 6-51 in ScobolType class 6-47 I/O operations, changing number of, in a TCP/IP session 2-14 J Japanese kanji-katana character set 3-4 Java applet, main 5-2 Java classes in J
N Index methods (continued) in Pic9P class 6-66 in Pic9V class 6-78 in PicN class 6-91 in PicX class 6-97 in ProgramUnit class 6-110 in ScLibUserConversion class 6-124 in ScobolGroupType class 6-47 in ScobolLib class 6-113 in ScobolType class 6-39 in ScreenField class 6-11 in ScreenFieldArray class 6-19 in ScreenFieldGroup class 6-26 in ServerReplyCode class 6-8 in Transform class 6-106 in UserConversion class 6-122 mapping of SCREEN COBOL paragraphs to 5-5 Modified data tag (MDT), not used by web clients
O Index NonStop™ Himalaya system See also NonStop™ Kernel operating system building web clients on 2-8 setting up build environment on 2-4, 2-6 Not enough data for scatter to working storage (message 3180) A-10 numeric data types, Java implementation of integer 6-54 noninteger 6-66, 6-78 real 6-78 O OCCURS clause, Java implementation of 6-17 OLD-CURSOR special register, Java implementation of 6-115 ON ERROR clause, Java implementation of 6-5 ON ERROR method of BEGINTRANSACTION… (message 3303) A-12 onLoad
Q Index PicX class constructor 6-98 details 6-96 literals 6-97 methods 6-97 port number, setting for router process 2-13 PRINT SCREEN statement, not supported B-2 PROFDBM utility 2-4, 3-5 profiles, user See user profiles program units, mapping to Java classes 5-3 ProgramUnit class constructor 6-110 data members 6-110 details 6-109 methods 6-110 protocols supported by router process 1-4 proxy servers, internet illustrated 1-2 support for 1-5 PW-TCP-PROCESSNAME special register 3-2 PW-TCP-SYSTEM-NAME specia
S Index ScobolTxnException class constructor 6-120 details 6-120 ScobolType class constructor 6-39 data members 6-39 details 6-38 methods 6-39 SCREEN COBOL data-type classes 6-38 features not supported for web clients B-1/B-4 modifying code for web clients 2-4 modifying source code 2-16 object files, preparing for conversion 2-2 paragraphs, mapping to Java methods 5-5 program units, mapping to Java classes 5-3 requesters, converting to web clients 2-3 types of programs supported for conversion 1-1 screen
S Index setADVISORY method in ScreenField class 6-12 in ScreenFieldArray class 6-20 setCharSet method 6-114 setCONTROLLEDBY method in ScreenField class 6-12 in ScreenFieldArray class 6-20 setCONVERTBLANKS method in ScreenField class 6-13 in ScreenFieldArray class 6-21 setCurrencySign method 6-111 setDecimalPointCharacter method 6-111 setFILL method in ScreenField class 6-13 in ScreenFieldArray class 6-21 setHighValues method in PicX class 6-102 in ScobolGroupType class 6-51 setHostValue method in Cursor c
T Index setZeroes method (continued) in ScobolGroupType class 6-53 SHADOWED [BY] clause, Java implementation of 6-15, 6-23 sockets protocol, support for 1-4 special registers Java classes for 6-112 user profiles 3-2 specifying the character set 6-114 starting page, HTML 5-2 STOP RUN statement, Java implementation of 6-112 stopRun method 6-112 StopRunException class constructor 6-121 details 6-120 symbols, use in conversion 2-2 Transaction mode violation (message 3027) A-4 Transform class constructor 6-10
V Index User profile server communication error (message 3311) A-13 user profiles actions of web client with 3-2 adding 3-5 adding Java code to web client 2-4 configuring server class for 2-14 configuring user profile server class 3-6 control file options 3-3 control file parameters for 2-14 database for 3-2 defined 3-1 definition and logging on 3-1 deleting 3-6 searching for 3-6 setting up the database 2-4 special registers for 3-2 updating 3-5 USER [CONVERSION] clause, Java implementation of 6-16, 6-24
Y Index Compaq NonStop Pathway/iTS Web Client Programming Manual— 520270-001 Index -14
