<!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>Move Window (QsnMovWin) API</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. --> <!-- DSMMST1 SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 --> <!-- at RCHVMW2 on 29 Jan 1999 at 16:05:09 --> <!-- Change History: --> <!-- YYMMDD USERID Change description --> <!--File Edited November 2001 --> <!--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>Move Window (QsnMovWin) API</h2> <div class="box" style="width: 60%;"> <br> Required Parameter Group:<br> <!-- iddvc RMBR --> <br> <table width="100%"> <tr> <td align="center" valign="top" width="10%">1</td> <td align="left" valign="top" width="50%">Window handle</td> <td align="left" valign="top" width="20%">Input</td> <td align="left" valign="top" width="20%">Binary(4)</td> </tr> <tr> <td align="center" valign="top">2</td> <td align="left" valign="top">Upper left row</td> <td align="left" valign="top">Input</td> <td align="left" valign="top">Binary(4)</td> </tr> <tr> <td align="center" valign="top">3</td> <td align="left" valign="top">Upper left column</td> <td align="left" valign="top">Input</td> <td align="left" valign="top">Binary(4)</td> </tr> </table> <br> Omissible Parameter:<br> <!-- iddvc RMBR --> <br> <table width="100%"> <tr> <td align="center" valign="top" width="10%">4</td> <td align="left" valign="top" width="50%">Error code</td> <td align="left" valign="top" width="20%">I/O</td> <td align="left" valign="top" width="20%">Char(*)</td> </tr> </table> <br> Returned Value:<br> <!-- iddvc RMBR --> <br> <table width="100%"> <tr> <td align="center" valign="top" width="10%"></td> <td align="left" valign="top" width="50%">Return code</td> <td align="left" valign="top" width="20%">Output</td> <td align="left" valign="top" width="20%">Binary(4)</td> </tr> </table> <br> Default Public Authority: *USE<br> <!-- iddvc RMBR --> <br> Service Program: QSNAPI<br> <!-- iddvc RMBR --> <br> Threadsafe: No<br> <!-- iddvc RMBR --> <br> </div> <p>The QsnMovWin API moves the window to the new upper left coordinate (upper left row, upper left column) specified. If the window can fit within the display at the location specified, it is moved to the new position. If a Change Window Coordinates exit routine is specified on the window description, it is called after the window is successfully moved. If the window is a full screen window, the API will complete successfully, but the window will not be moved.</p> <br> <h3>Authorities and Locks</h3> <p>None</p> <br> <h3>Required Parameter Group</h3> <dl> <dt><strong>Window handle</strong></dt> <dd>INPUT; BINARY(4) <p>A handle for the window to be moved.</p> </dd> <dt><strong>Upper left row</strong></dt> <dd>INPUT; BINARY(4) <p>The absolute screen row for the new upper left corner of the window.</p> </dd> <dt><strong>Upper left col</strong></dt> <dd>INPUT; BINARY(4) <p>The absolute screen column for the new upper left corner of the window.</p> </dd> </dl> <br> <h3>Omissible Parameter</h3> <dl> <dt><strong>Error code</strong></dt> <dd>I/O; CHAR(*) <p>The structure in which to return error information. For the format of the structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>. If this parameter is omitted, diagnostic and escape messages are issued to the application.</p> </dd> </dl> <br> <h3>Returned Value</h3> <dl> <dt><strong>Return code</strong></dt> <dd>OUTPUT; BINARY(4) <p>A return code indicating the result of the operation. The value returned will be 0 if the operation was successful, or -1 otherwise.</p> </dd> </dl> <br> <h3>Error Messages</h3> <table width="100%" cellpadding="3"> <!-- cols="15 85" --> <tr> <th align="left" valign="top">Message ID</th> <th align="left" valign="top">Error Message Text</th> </tr> <tr> <td align="left" valign="top">CPF24B4 E</td> <td valign="top">Severe error while addressing parameter list.</td> </tr> <tr> <td align="left" valign="top">CPF3CF1 E</td> <td valign="top">Error code parameter not valid.</td> </tr> <tr> <td align="left" valign="top">CPF3CF2 E</td> <td valign="top">Error(s) occurred during running of &1 API.</td> </tr> <tr> <td align="left" valign="top">CPFA318 E</td> <td valign="top">Error calling exit routine.</td> </tr> <tr> <td align="left" valign="top">CPFA31E E</td> <td valign="top">Required parameter &1 omitted.</td> </tr> <tr> <td align="left" valign="top">CPFA343 E</td> <td valign="top">Output operation not done.</td> </tr> <tr> <td align="left" valign="top">CPFA344 E</td> <td valign="top">The file &2 in library &3 is not valid.</td> </tr> <tr> <td align="left" valign="top">CPFA345 E</td> <td valign="top">The invite active flag is not valid.</td> </tr> <tr> <td align="left" valign="top">CPFA3A2 E</td> <td valign="top">Window does not fit on screen.</td> </tr> <tr> <td align="left" valign="top">CPFA3A4 E</td> <td valign="top">Specified window is not active.</td> </tr> <tr> <td align="left" valign="top">CPFA3AA E</td> <td valign="top">Window handle incorrect.</td> </tr> </table> <br> <hr> API introduced: V2R3 <hr> <center> <table cellpadding="2" cellspacing="2"> <tr align="center"> <td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href= "dsm.htm">Dynamic Screen Manager APIs</a> | <a href="aplist.htm">APIs by category</a></td> </tr> </table> </center> </body> </html>