<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation"> <title>QP2TERM()--Run an i5/OS PASE Terminal Session</title> <!-- Begin Header Records --> <!-- All rights reserved. Licensed Materials Property of IBM --> <!-- US Government Users Restricted Rights --> <!-- Use, duplication or disclosure restricted by --> <!-- GSA ADP Schedule Contract with IBM Corp. --> <!-- Change History: --> <!-- YYMMDD USERID Change description --> <!-- Edited by Kersten Jan 02 --> <!-- Created by V2DCIJB on 23 Nov 1999 --> <!--End Header Records --> <link rel="stylesheet" type="text/css" href="../rzahg/ic.css"> </head> <body> <a name="Top_Of_Page"></a> <!-- Java sync-link --> <script language="Javascript" src="../rzahg/synch.js" type="text/javascript"> </script> <h2>QP2TERM()--Run an i5/OS PASE Terminal Session</h2> <div class="box" style="width: 50%;"> <br> Syntax <pre> #include <qp2term.h> void QP2TERM(...); </pre> <br> Default Public Authority: *USE<br> <!-- iddvc RMBR --> <br> Threadsafe: No<br> <!-- iddvc RMBR --> <br> </div> <p>The QP2TERM() program runs an interactive terminal session that starts a batch job to run an i5/OS Portable Application Solutions Environment (i5/OS PASE) program. This program uses the workstation display in the interactive to present output and accept input for files stdin, stdout, and stderr in the batch job.</p> <br> <h3>Parameters</h3> <dl> <dt><strong>argument strings</strong></dt> <dd>(Input) Optional pointers to null-terminated character strings that specify the path name of the i5/OS PASE program to run and any argument strings to pass to the program. If no parameters are specified, QP2TERM runs the default i5/OS PASE shell as an interactive login shell. The default i5/OS PASE shell is an implementation of the Korn shell, with path name /QOpenSys/usr/bin/sh. <p><strong>Note:</strong> When calling QP2TERM from CL, be sure to quote any argument string that could be interpreted as a numeric value. CL converts unquoted numeric arguments to decimal or floating-point format, which does not match the assumption made by QP2TERM and i5/OS PASE programs that all arguments are null-terminated character strings.</p> </dd> </dl> <br> <h3>Authorities</h3> <table border cellpadding="5"> <!-- cols="80 20" --> <tr> <th align="left" valign="bottom">Object Referred to</th> <th align="center" valign="bottom">Authority<br> Required</th> </tr> <tr> <td align="left" valign="top">Each directory in the path to the i5/OS PASE program and shared libraries</td> <td align="center" valign="top">*X</td> </tr> <tr> <td align="left" valign="top">i5/OS PASE program (not a shell script) in a local file system</td> <td align="center" valign="top">*X</td> </tr> <tr> <td align="left" valign="top">i5/OS PASE program in a remote file system or shell script</td> <td align="center" valign="top">*RX</td> </tr> <tr> <td align="left" valign="top">i5/OS PASE shared library</td> <td align="center" valign="top">*R</td> </tr> </table> <br> <br> <h3>Return Value</h3> <p>QP2TERM returns no function result. Escape messages are sent to report errors.</p> <br> <h3>Error Messages</h3> <table width="100%" cellpadding="5"> <tr> <th align="left" valign="top">Message ID</th> <th align="left" valign="top">Error Message Text</th> </tr> <tr> <td width="15%" valign="top">CPFB9C4 E</td> <td width="85%" valign="top">Error running i5/OS PASE terminal session, reason code &1, errno &2.</td> </tr> <tr> <td align="left" valign="top">CPFB9C9 E</td> <td align="left" valign="top">Terminal session already in use.</td> </tr> <tr> <td align="left" valign="top">CPFB9CA E</td> <td align="left" valign="top">Batch job ended in error.</td> </tr> </table> <br><br> <h3>Usage Notes</h3> <ol> <li>QP2TERM uses the Qp0zStartTerminal API to manage the interactive display and start a batch job. The batch job copies most attributes of the interactive job and calls program QP2SHELL to run the i5/OS PASE program. See <a href= "qp2shell.htm">QP2SHELL()--Run an i5/OS PASE Shell Program</a> for details about running an i5/OS PASE shell program.<br> <br> </li> <li>QP2TERM copies all ILE environment variables from the interactive job to the batch job before starting the batch job, except the following ILE environment variables, which are set or replaced in the batch job. These changes affect the batch job only. They do not modify the environment in the job that called QP2TERM.<br> <br> <table cellpadding="5"> <!-- cols="35 65" --> <tr> <td width="15%" valign="top"><em>COLUMNS</em></td> <td width="85%" valign="top">If COLUMNS is not already set, QP2TERM sets it to the number of columns available for program output on the interactive display.</td> </tr> <tr> <td align="left" valign="top"><em>ROWS</em></td> <td align="left" valign="top">If ROWS is not already set, QP2TERM sets it to the number of rows available for program output on the interactive display.</td> </tr> <tr> <td align="left" valign="top"><em>QIBM_USE_DESCRIPTOR_STDIO=I</em></td> <td align="left" valign="top">QP2TERM sets QIBM_USE_DESCRIPTOR_STDIO to ensure that files stdin, stdout, and stderr use Integrated File System descriptors 0, 1, and 2. The terminal session manager attaches open pipes to these file descriptors in the batch job.</td> </tr> <tr> <td align="left" valign="top" nowrap><em>QIBM_PASE_DESCRIPTOR_STDIO=T</em></td> <td align="left" valign="top">QP2TERM sets QIBM_PASE_DESCRIPTOR_STDIO to ensure that i5/OS PASE runtime does ASCII/EBCDIC text conversion for data that the i5/OS PASE program reads or writes to files stdin, stdout, and stderr.</td> </tr> </table> </li> </ol> <br> <h3>Related Information</h3> <ul> <li><a href="startrml.htm">Qp0zStartTerminal()--Start a Terminal Session</a><br> <br> </li> <li><a href="qp2shell.htm">QP2SHELL()--Run an i5/OS PASE Shell Program</a></li> </ul> <br> <hr> API introduced: V4R5 <hr> <center> <table cellpadding="2" cellspacing="2"> <tr align="center"> <td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href= "pase1.htm">i5/OS PASE APIs</a> | <a href="aplist.htm">APIs by category</a> </td> </tr> </table> </center> </body> </html>